get_collection
Get detailed information about a specific GitBook collection
LABSCO SUMMARY
Documentation you can query, rather than documentation somebody has to go and read.
The read-only shape fits the main use exactly: letting an agent answer from the docs your team already wrote, with search scoped to a space and retrieval by the path a human would quote at you. Nothing writes back, so a correction discovered this way still has to be made in GitBook by hand.
What it is
A read-side server over the GitBook API with 12 tools across organizations, collections, spaces, pages and uploaded files.
What you get
- The organizations an API token can reach, and the spaces and collections beneath them
- A space's complete content structure and page hierarchy
- Page content by page id or by path, with format and metadata options
- Text search within a space
- Files uploaded to a space, listed and then inspected individually
- Collections resolved to the spaces that belong to them
Requirements
GITBOOK_API_TOKEN, and the organization you intend to work in — the organization listing shows which ones that token reaches, and most calls take an organizationId or a spaceId.
Setup effort
One command plus a key — npx gitbook-mcp, then supply credentials
USE CASES
01
Answering a support question out of the documentation
Find the space the answer would live in, search inside it for the phrasing the customer used, then pull the page so the reply quotes what the docs actually say.
02
Opening the page somebody linked you
A shared link gives you a path, not a page id — fetch by path directly instead of walking the hierarchy to work out which page it refers to.
03
Getting oriented in a workspace you have not seen before
Start from the organizations the token reaches, expand the collections into their spaces, and read one space's structure to see how the documentation is arranged before reading any of it.
12 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_collection_spaces
List all spaces that belong to a specific GitBook collection
get_file
Get detailed information about a specific file uploaded to a GitBook space
get_page_by_path
Retrieve a page from a GitBook space using its path instead of page ID
get_page_content
Retrieve the content of a specific page from a GitBook space, with options for format and metadata
get_space
Get detailed information about a specific GitBook space
get_space_content
Get the complete content structure and page hierarchy of a GitBook space
get_space_files
List all files (images, documents, etc.) uploaded to a GitBook space
list_collections
List all collections in a GitBook organization, optionally filtered by organization ID
list_organizations
List all GitBook organizations accessible with the current API token
list_spaces
List all spaces in a GitBook organization, optionally filtered by organization ID
search_content
Search for content within a GitBook space using a text query
BEFORE YOU INSTALL
What to know first
Tools you get
12 tools when we connected. Every tool is read-only; nothing creates, edits or publishes a page. The 6 prompts are separate and are not tools.
Requires
- npx on PATH
- Node.js 20+
- GITBOOK_API_TOKEN in your environment
Where it runs
All 3 documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 12 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npx gitbook-mcpMCP Clients
GitHub Copilot in VS Code
GITHUB COPILOT IN VS CODE · JSON
{
"servers": {
"gitbook-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"gitbook-mcp",
"--organization-id=<YOUR_ORGANIZATION_ID>"
],
"env": {
"GITBOOK_API_TOKEN": "<YOUR_GITBOOK_API_TOKEN>"
}
}
}
}Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"gitbook-mcp": {
"command": "npx",
"args": [
"gitbook-mcp",
"--organization-id=<YOUR_ORGANIZATION_ID>"
],
"env": {
"GITBOOK_API_TOKEN": "<YOUR_GITBOOK_API_TOKEN>"
}
}
}
}GitHub Copilot in JetBrains
GITHUB COPILOT IN JETBRAINS · JSON
{
"servers": {
"gitbook-mcp": {
"command": "npx",
"args": [
"gitbook-mcp",
"--organization-id=<YOUR_ORGANIZATION_ID>"
],
"env": {
"GITBOOK_API_TOKEN": "<YOUR_GITBOOK_API_TOKEN>"
}
}
}
}
