Gitbook MCP Server
GitBook content access via API for Organizations, Spaces, and Collections.
Data last scanned 2 days ago · Reviewed 2 days ago
Overview
This MCP server provides an interface to GitBook's platform, allowing AI assistants to interact with documentation workflows. It features 12 specialized tools for retrieving organizational data and content, alongside 6 pre-built prompts designed to streamline documentation management. Setup requires an API token generated from the GitBook developer portal and an optional organization ID. The server is designed to integrate into various environments, including Claude Desktop, VS Code, and JetBrains IDEs, by running through a standard npx command.
Our verdict
The GitBook MCP Server carries a high-risk security rating of 32/100, primarily because it is a community-maintained project rather than an official GitBook release. Additionally, critical security aspects such as OAuth support, read-only mode, and authentication mechanisms have not yet been editorially reviewed. Given the lack of formal oversight and the potential for handling sensitive documentation data, users should exercise caution and review the codebase before deployment in non-experimental settings.
- Includes 12 distinct tools for managing GitBook content operations.
- Provides 6 AI-optimized prompts to assist with documentation workflows.
- Small codebase with only 4 direct dependencies.
- Licensed under the permissive MIT license.
- Security risk level is high due to lack of editorial review.
- Last commit occurred 170 days ago, suggesting limited maintenance.
- Relies on community contributions with only 2 project maintainers.
- Authentication, OAuth, and read-only modes remain unverified.
Setup
{
"mcpServers": {
"gitbook-mcp": {
"args": [
"-y",
"gitbook-mcp"
],
"command": "npx"
}
}
}Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.
- No read-only mode — running this grants full read/write access.
- No built-in authentication — anyone with access to this config can invoke every tool it exposes.
Tools
| Tool | Description | Risk |
|---|---|---|
| list_organizations | Lists all accessible GitBook organizations. | low |
| list_spaces | Lists spaces, optionally filtered by organization. | low |
| get_space | Retrieves detailed information about a specific space. | low |
| get_space_content | Retrieves the content structure and pages of a space. | low |
| search_content | Searches for content within a space using full-text search. | low |
| get_page_content | Retrieves the content of a specific page. | low |
| get_page_by_path | Retrieves page content using the page path. | low |
| get_space_files | Lists all files in a space. | low |
| get_file | Retrieves details of a specific file. | low |
| list_collections | Lists all accessible collections. | low |
Compatibility
| Client | Local | Docker | Remote | Read-only |
|---|---|---|---|---|
| ChatGPT | ||||
| Claude Desktop | ||||
| Cursor | ||||
| VS Code | ||||
| Windsurf |
Frequently asked questions
›What prerequisites are required to use this MCP server?
You need a GitBook API token, which can be generated at the GitBook developer portal, and your GitBook Organization ID.
›How can I find my Organization ID and Space ID?
You can use the list_organizations tool to find your Organization ID and the list_spaces tool to retrieve available space IDs.
›Does the server support .env files for configuration?
No, .env files are only supported for local development and will not work when running the server via npx.
›How can I configure the server's default organization or space?
You can set these via CLI arguments such as --organization-id and --space-id, or by using system environment variables.
Changelog
- ImprovedRelease v1.0.4
2025-06-29
- NewRelease v1.0.3
2025-06-19
- NewRelease v1.0.2
2025-06-15
- Fix
- Improvedv1.0.0 - Initial Release
2025-06-15
Badge
Maintain this server? Add the live badge to your README.