Gitbook MCP Server

GitBook content access via API for Organizations, Spaces, and Collections.

Data last scanned 2 days ago · Reviewed 2 days ago

3212 tools25JavaScriptMIT

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

Claude Desktop
{
  "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

ToolDescriptionRisk
list_organizationsLists all accessible GitBook organizations.low
list_spacesLists spaces, optionally filtered by organization.low
get_spaceRetrieves detailed information about a specific space.low
get_space_contentRetrieves the content structure and pages of a space.low
search_contentSearches for content within a space using full-text search.low
get_page_contentRetrieves the content of a specific page.low
get_page_by_pathRetrieves page content using the page path.low
get_space_filesLists all files in a space.low
get_fileRetrieves details of a specific file.low
list_collectionsLists all accessible collections.low

Compatibility

ClientLocalDockerRemoteRead-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

Badge

Gitbook MCP Server security score, rated on RepoAI

Maintain this server? Add the live badge to your README.