Skip to main content
Glama

gitbook-mcp

A Model Context Protocol server for GitBook. It lets an MCP host (Claude Code, Claude Desktop, Cursor, …) read your GitBook content and drive a change-request write workflow, over stdio or streamable HTTP.

Built on the official @gitbook/api client and @modelcontextprotocol/sdk 1.x.

  • Full API coverage: ~345 tools across 11 config-gated toolsets. The default (core + change-requests) keeps the surface small; write and destructive tools are gated by read-only mode plus an opt-in.

  • Resources: pages addressable as gitbook://{spaceId}/{pageId}.

  • Two transports: stdio (local) and streamable HTTP (multi-session, bearer-gated).

  • Resilient: request timeouts, bounded retries with full-jitter backoff, rate-limit handling.

  • Safe: read-only mode, env-only token, secret redaction, localhost-bound HTTP.

Status: published as @hoyongjin/gitbook-mcp (v2.0.0), with the original 11 tools enabled by default. Covered by unit, MCP-protocol, and manifest-contract tests. The stdio transport suits local IDE/CLI use. The HTTP transport adds bearer auth, DNS-rebinding protection, a session cap with idle reaper, per-IP rate limiting, health/readiness probes, and Prometheus metrics for hosted use.


⚠️ What GitBook's API can and cannot write

GitBook's public API has no direct "edit this page body" endpoint (createPage/updatePage exist only as the GitBook Assistant's internal tool names, not as REST methods). Content authoring goes through:

  1. Change requests: open a draft (gitbook_create_change_request), review, then gitbook_merge_change_request to publish.

  2. Content import: gitbook_import_content imports a web page URL into a space/change-request/page, AI-enhanced by default. This is the supported "write content" primitive. Imports are asynchronous, and GitBook exposes no status-poll endpoint.

  3. Git Sync: for fine-grained, paragraph-level authoring, connect the space to a Git repo and edit markdown there. (Out of scope for this server; it is the right path if you need precise prose edits.)

So the server exposes many reads and a single coarse, review-gated write path. It cannot rewrite a specific paragraph through the API.


Related MCP server: Notion MCP Server

Install

# From source (local use):
cd gitbook-mcp && npm install && npm run build
# → run with:  node dist/index.js   (or `npm start`)

# Or, once published:
npx @hoyongjin/gitbook-mcp

The package is scoped to @hoyongjin/gitbook-mcp (the unscoped gitbook-mcp on npm belongs to a different project). Make sure your npm account owns the @hoyongjin scope before publishing.

Create a token at GitBook → Settings → Developer → Personal access tokens.

Configure in your MCP client

Claude Code

# Local build:
claude mcp add gitbook \
  --env GITBOOK_TOKEN=gb_api_xxx \
  -- node /absolute/path/to/gitbook-mcp/dist/index.js

.mcp.json / Claude Desktop config

{
  "mcpServers": {
    "gitbook": {
      "command": "node",
      "args": ["/absolute/path/to/gitbook-mcp/dist/index.js"],
      "env": { "GITBOOK_TOKEN": "gb_api_xxx" }
    }
  }
}

(After publishing, replace command/args with "command": "npx", "args": ["@hoyongjin/gitbook-mcp"].)

Run read-only (recommended unless you need writes) by adding "--read-only" to args, or "GITBOOK_READONLY": "true" to env.

Configuration

All configuration is via environment variables (see .env.example). The token is never taken from a CLI argument.

Variable

Default

Description

GITBOOK_TOKEN

—

Required. Personal access token (account-wide privileges).

GITBOOK_ENDPOINT

https://api.gitbook.com

API base URL.

GITBOOK_READONLY

false

Hide all write/destructive tools when true.

GITBOOK_TOOLSETS

core,change-requests

Comma-separated toolsets to enable, or all. Unset/empty → the default two. Unknown key fails closed. See Toolsets.

GITBOOK_ALLOW_DESTRUCTIVE

false

Opt-in to register new destructive ops (deletes, unpublish, admin removals). The legacy merge tool is exempt.

GITBOOK_TRANSPORT

stdio

stdio or http.

GITBOOK_HTTP_HOST

127.0.0.1

HTTP bind host.

GITBOOK_HTTP_PORT

3000

HTTP port.

GITBOOK_HTTP_AUTH_TOKEN

—

Bearer token required on the HTTP transport.

GITBOOK_HTTP_MAX_SESSIONS

256

Concurrent-session cap; new initializes past it get 503 (1–100000).

GITBOOK_HTTP_SESSION_TTL_MS

300000

Idle-session reaper TTL (1 000–86 400 000).

GITBOOK_HTTP_SESSION_MAX_LIFETIME_MS

3600000

Absolute session lifetime; reaped regardless of activity.

GITBOOK_HTTP_TRUST_PROXY

false

Trust X-Forwarded-* (enable only behind a trusted reverse proxy).

GITBOOK_HTTP_ALLOWED_HOSTS

—

Comma-separated hosts appended to the DNS-rebinding allow-list. Required for proxied/non-loopback access (e.g. mcp.example.com).

GITBOOK_HTTP_ALLOWED_ORIGINS

—

Comma-separated origins appended to the allow-list (e.g. https://mcp.example.com).

GITBOOK_HTTP_RATE_LIMIT_WINDOW_MS

60000

Rate-limit window per client IP.

GITBOOK_HTTP_RATE_LIMIT_MAX

120

Max /mcp requests per window per IP; 0 disables.

GITBOOK_LOG_LEVEL

info

debug/info/warn/error (logs → stderr).

GITBOOK_TIMEOUT_MS

30000

Per-request timeout (1 000–120 000).

GITBOOK_MAX_RETRIES

5

Max retries on 429/5xx/transport errors (0–10).

GITBOOK_MAX_CONCURRENCY

8

Max concurrent outbound GitBook HTTP requests per instance (1–256).

CLI flags: --stdio / --http (transport), --read-only, --toolsets <csv|all>, --allow-destructive, --port <n>.

Tools

The server covers the full GitBook API (~345 tools), organized into toolsets you enable with GITBOOK_TOOLSETS. By default only core + change-requests are on (~89 tools), so tools/list stays small and tool selection stays accurate. Set GITBOOK_TOOLSETS=all for everything, or list the ones you need (e.g. GITBOOK_TOOLSETS=core,change-requests,sites).

Every tool is one API endpoint with its own input schema. Read tools are always available, write tools need !readOnly, and new destructive tools (deletes, unpublish, admin removals) also need GITBOOK_ALLOW_DESTRUCTIVE=true.

Toolset

Default

Scope

core

✅

Identity, orgs/spaces/pages reads, search, content + import_content.

change-requests

✅

Full CR loop: create, list/diff, reviews, reviewers, comments, merge.

collections

Collections + collection permissions.

sites

Sites, structure, customization, redirects, share links, permissions.

site-ai

Ask AI, agent settings, questions, glossary-adjacent AI.

site-insights

Analytics/insights, context connections, channels, site MCP servers.

integrations

Integration install/configure/token + space integrations.

data

OpenAPI specs, translations, glossary, custom fonts, storage.

git

Git Sync: import/export, provider installations, repo/branch listing.

public

URL→content resolution, subdomains, custom hostnames.

org-admin

Org members, teams, invites, SSO, permissions (highest privilege).

The 11 original tools keep their exact names and live in core / change-requests, so existing setups are unchanged. Per-tool parameters are delivered live via each tool's MCP description + input schema.

Excluded carve-outs: 5 streaming (SSE) AI endpoints, 2 ephemeral PDF-URL generators, and a few trivial auth/heartbeat ops are not exposed as tools (the non-streaming AI equivalents are).

List tools (*_list_*, search) accept a body with limit/page and return nextCursor when more results exist. Typical write flow: create_change_request → import_content (target that CR) → review/diff → merge_change_request.

Resources

Pages are exposed as resources at gitbook://{spaceId}/{pageId} (rendered as markdown). Enumeration is intentionally not provided; discover page ids via gitbook_list_pages / gitbook_search, then read by URI.

Transports

  • stdio (default): one server per process; the token stays in-process. Best for local IDE/CLI integrations.

  • streamable HTTP (--http): one MCP session per mcp-session-id. Binds to 127.0.0.1 and enables DNS-rebinding protection (Host/Origin allow-lists). When GITBOOK_HTTP_AUTH_TOKEN is set, every request needs a constant-time-compared bearer token. Binding to a non-loopback host without an auth token is refused (fail-closed). Sessions are capped and idle-reaped; the /mcp endpoint is per-IP rate-limited. Operational endpoints: GET /healthz /livez /readyz (unauthenticated probes) and GET /metrics (Prometheus; bearer-gated when an auth token is set). Behind a TLS-terminating reverse proxy, set GITBOOK_HTTP_TRUST_PROXY=true and GITBOOK_HTTP_ALLOWED_HOSTS=<your-public-host>: DNS-rebinding protection matches the exact Host header, so a proxied or non-loopback deployment (including the Docker image, which binds 0.0.0.0) must add its public host(s) or every request is rejected with 403 Invalid Host. A Dockerfile is provided.

GITBOOK_TOKEN=… GITBOOK_HTTP_AUTH_TOKEN=… gitbook-mcp --http --port 3000
# → POST/GET/DELETE http://127.0.0.1:3000/mcp   ·   GET /healthz   ·   GET /metrics

Development

npm install
npm run typecheck   # tsc on src + test
npm run lint        # eslint
npm run format      # prettier --write   (format:check verifies)
npm test            # vitest: unit + protocol + manifest-contract tests
npm run generate:manifest  # regenerate src/tools/manifest.ts from @gitbook/api (CI checks drift)
npm run test:coverage  # + v8 coverage with an 80% gate
npm run build       # tsc → dist/ (+ chmod the bin)

CI (.github/workflows/ci.yml) runs npm audit → typecheck → lint → format:check → build → coverage on Node 20 & 22, then asserts a clean git diff. CodeQL and Dependabot run separately.

Architecture

src/
  index.ts            launcher: load config → pick transport → graceful shutdown
  config.ts           zod-validated env + CLI overrides (frozen Config)
  logger.ts           structured stderr logging + secret redaction + correlation
  request-context.ts  AsyncLocalStorage requestId/tool (log correlation)
  metrics.ts          in-process Prometheus registry (served at /metrics)
  limiter.ts          async concurrency semaphore (outbound rate control)
  server.ts           createServer(): McpServer factory (tools + resources)
  resources.ts        gitbook://{spaceId}/{pageId}
  version.ts          stable SERVER_NAME + runtime SERVER_VERSION (from package.json)
  gitbook/
    client.ts         typed wrapper over @gitbook/api (cursor pagination → {items,nextCursor})
    resilient-fetch.ts timeouts + retry/backoff + concurrency cap; injected as the client's fetch
    import-url.ts     URL guard for server-side-fetch ops (http(s) only, no credentials)
    errors.ts         HTTP/transport error classification → safe messages
  tools/
    manifest.ts       GENERATED tool surface (one row per API op; source of truth)
    toolsets.ts       toolset keys + defaults
    index.ts          manifest-driven registration under toolset/read-only/destructive gates
    factory.ts        generic handler factory (every non-bespoke op)
    bespoke.ts        the 11 grandfathered tools (hand-written handlers)
    shared.ts         ToolContext + result/guard helpers + annotation presets
  transports/
    stdio.ts http.ts  the two transports (http: sessions, rate limit, health, metrics)

Notes / gotchas (pinned to @gitbook/api 0.183.0)

  • tsconfig uses moduleResolution: "Bundler", not NodeNext. @gitbook/api 0.183 ships a .d.ts that re-exports with extensionless relative specifiers (export * from './client'); under NodeNext those don't resolve and the entire client surface (and the GitBookAPI namespace members) silently disappears. Bundler resolution accepts them, giving full typing with no facade. Internal imports use explicit .js extensions so the emitted ESM runs on Node.

  • Import runs live under the singular client.org namespace, not the plural client.orgs (which holds list/search). They are different runtime objects.

  • gitbook_get_page markdown vs document: format=markdown returns rendered markdown; format=document returns GitBook's structured Document JSON.

  • Node ≥ 20 (global fetch, AbortSignal.any).

License

MIT

Available Tools

89 tools
gitbook_apply_template_to_spaceApply a template to a space.C

Apply a template to a space.. (POST /spaces/{spaceId}/content/template)

Inputs: spaceId (required), body.

gitbook_cancel_import_runCancel an import runA

Cancel an import run. (POST /org/{organizationId}/imports/{importRunId}/cancel) Asynchronous — GitBook exposes no status endpoint, so treat the result as 'started, not confirmed' and verify in GitBook.

Inputs: organizationId (required), importRunId (required).

gitbook_comment_change_requestComment on a change requestB

Post a markdown comment on a change request (review feedback / notes).

Inputs: spaceId (required), changeRequestId (required), body (required), page.

gitbook_create_change_requestOpen a change requestA

Create a change request (draft branch) on a space. Returns its id to target with gitbook_import_content / gitbook_comment_change_request, then gitbook_merge_change_request to publish.

Inputs: spaceId (required), subject.

gitbook_create_spaceCreate a spaceB

Create a space. (POST /orgs/{organizationId}/spaces)

Inputs: organizationId (required), body.

gitbook_duplicate_spaceDuplicate a spaceC

Duplicate a space. (POST /spaces/{spaceId}/duplicate)

Inputs: spaceId (required).

gitbook_get_change_request_by_idGet a change request by its IDA
Read-onlyIdempotent

Get a change request by its ID. (GET /spaces/{spaceId}/change-requests/{changeRequestId})

Inputs: spaceId (required), changeRequestId (required).

gitbook_get_change_request_changesGet change request semantic changesB
Read-onlyIdempotent

Get change request semantic changes. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/changes)

Inputs: spaceId (required), changeRequestId (required), body.

gitbook_get_change_request_pdfGet a URL of the content of a change request as PDFA
Read-onlyIdempotent

Get a URL of the content of a change request as PDF. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/pdf)

Inputs: spaceId (required), changeRequestId (required), body.

gitbook_get_change_request_review_by_idGet a change request review by its IDB
Read-onlyIdempotent

Get a change request review by its ID. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/reviews/{reviewId})

Inputs: spaceId (required), changeRequestId (required), reviewId (required), body.

gitbook_get_comment_in_change_requestGet a change request commentB
Read-onlyIdempotent

Get a change request comment. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/comments/{commentId})

Inputs: spaceId (required), changeRequestId (required), commentId (required), body.

gitbook_get_comment_in_spaceGet a space commentA
Read-onlyIdempotent

Get a space comment. (GET /spaces/{spaceId}/comments/{commentId})

Inputs: spaceId (required), commentId (required), body.

gitbook_get_comment_reply_in_change_requestGet a change request comment replyB
Read-onlyIdempotent

Get a change request comment reply. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/comments/{commentId}/replies/{commentReplyId})

Inputs: spaceId (required), changeRequestId (required), commentId (required), commentReplyId (required), +1 more.

gitbook_get_comment_reply_in_spaceGet a space comment replyA
Read-onlyIdempotent

Get a space comment reply. (GET /spaces/{spaceId}/comments/{commentId}/replies/{commentReplyId})

Inputs: spaceId (required), commentId (required), commentReplyId (required), body.

gitbook_get_computed_documentGet a space computed documentB

Get a space computed document. (POST /spaces/{spaceId}/content/computed/document)

Inputs: spaceId (required), body.

gitbook_get_computed_revisionGet a space computed revisionC

Get a space computed revision. (POST /spaces/{spaceId}/content/computed/revision)

Inputs: spaceId (required), body.

gitbook_get_contributors_by_change_request_idGet all contribors of a change requestB
Read-onlyIdempotent

Get all contribors of a change request. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/contributors)

Inputs: spaceId (required), changeRequestId (required).

gitbook_get_current_revisionGet a space current revisionA
Read-onlyIdempotent

Get a space current revision. (GET /spaces/{spaceId}/content)

Inputs: spaceId (required), body.

gitbook_get_document_by_idGet a space document by its IDA
Read-onlyIdempotent

Get a space document by its ID. (GET /spaces/{spaceId}/documents/{documentId})

Inputs: spaceId (required), documentId (required), body.

gitbook_get_embed_by_url_in_spaceResolve a URL to an embed in a given spaceB
Read-onlyIdempotent

Resolve a URL to an embed in a given space. (GET /spaces/{spaceId}/embed)

Inputs: spaceId (required), body.

gitbook_get_file_by_idGet a space file by its IDA
Read-onlyIdempotent

Get a space file by its ID. (GET /spaces/{spaceId}/content/files/{fileId})

Inputs: spaceId (required), fileId (required), body.

gitbook_get_file_in_change_request_by_idGet a change request file by its IDA
Read-onlyIdempotent

Get a change request file by its ID. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/content/files/{fileId})

Inputs: spaceId (required), changeRequestId (required), fileId (required), body.

gitbook_get_file_in_revision_by_idGet a space revision file by its IDB
Read-onlyIdempotent

Get a space revision file by its ID. (GET /spaces/{spaceId}/revisions/{revisionId}/files/{fileId})

Inputs: spaceId (required), revisionId (required), fileId (required), body.

gitbook_get_organization_by_idGet an organization by its IDA
Read-onlyIdempotent

Get an organization by its ID. (GET /orgs/{organizationId})

Inputs: organizationId (required).

gitbook_get_pageGet a page's contentA
Read-onlyIdempotent

Read a page by id. format='markdown' (default) returns rendered markdown; format='document' returns GitBook's structured Document JSON.

Inputs: spaceId (required), pageId (required), format.

gitbook_get_page_by_pathGet a space page by its pathA
Read-onlyIdempotent

Get a space page by its path. (GET /spaces/{spaceId}/content/path/{pagePath})

Inputs: spaceId (required), pagePath (required), body.

gitbook_get_page_document_in_revision_by_idGet the document of a page in a revisionA
Read-onlyIdempotent

Get the document of a page in a revision. (GET /spaces/{spaceId}/revisions/{revisionId}/page/{pageId}/document)

Inputs: spaceId (required), revisionId (required), pageId (required), body.

gitbook_get_page_in_change_request_by_idGet a change request page by its IDB
Read-onlyIdempotent

Get a change request page by its ID. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/content/page/{pageId})

Inputs: spaceId (required), changeRequestId (required), pageId (required), body.

gitbook_get_page_in_change_request_by_pathGet a change request page by its pathB
Read-onlyIdempotent

Get a change request page by its path. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/content/path/{pagePath})

Inputs: spaceId (required), changeRequestId (required), pagePath (required), body.

gitbook_get_page_in_revision_by_idGet a space revision page by its IDA
Read-onlyIdempotent

Get a space revision page by its ID. (GET /spaces/{spaceId}/revisions/{revisionId}/page/{pageId})

Inputs: spaceId (required), revisionId (required), pageId (required), body.

gitbook_get_page_in_revision_by_pathGet a space revision page by its pathB
Read-onlyIdempotent

Get a space revision page by its path. (GET /spaces/{spaceId}/revisions/{revisionId}/path/{pagePath})

Inputs: spaceId (required), revisionId (required), pagePath (required), body.

gitbook_get_requested_reviewers_by_change_request_idGet all change request reviewersA
Read-onlyIdempotent

Get all change request reviewers. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/requested-reviewers)

Inputs: spaceId (required), changeRequestId (required), body.

gitbook_get_reusable_content_by_idGet a space reusable content by its IDA
Read-onlyIdempotent

Get a space reusable content by its ID. (GET /spaces/{spaceId}/content/reusable-contents/{reusableContentId})

Inputs: spaceId (required), reusableContentId (required), body.

gitbook_get_reusable_content_document_in_revision_by_idGet the document of a reusable content in a revisionB
Read-onlyIdempotent

Get the document of a reusable content in a revision. (GET /spaces/{spaceId}/revisions/{revisionId}/reusable-contents/{reusableContentId}/document)

Inputs: spaceId (required), revisionId (required), reusableContentId (required), body.

gitbook_get_reusable_content_in_change_request_by_idGet a change request reusable content by its IDA
Read-onlyIdempotent

Get a change request reusable content by its ID. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/content/reusable-contents/{reusableContentId})

Inputs: spaceId (required), changeRequestId (required), reusableContentId (required), body.

gitbook_get_reusable_content_in_revision_by_idGet a space revision reusable content by its IDA
Read-onlyIdempotent

Get a space revision reusable content by its ID. (GET /spaces/{spaceId}/revisions/{revisionId}/reusable-contents/{reusableContentId})

Inputs: spaceId (required), revisionId (required), reusableContentId (required), body.

gitbook_get_reviews_by_change_request_idList all change request reviewsA
Read-onlyIdempotent

List all change request reviews. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/reviews)

Inputs: spaceId (required), changeRequestId (required), body.

gitbook_get_revision_by_idGet a space revisionC
Read-onlyIdempotent

Get a space revision. (GET /spaces/{spaceId}/revisions/{revisionId})

Inputs: spaceId (required), revisionId (required), body.

gitbook_get_revision_of_change_request_by_idGet a change request the latest content revisionB
Read-onlyIdempotent

Get a change request the latest content revision. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/content)

Inputs: spaceId (required), changeRequestId (required), body.

gitbook_get_revision_semantic_changesGet space revision semantic changesB
Read-onlyIdempotent

Get space revision semantic changes. (GET /spaces/{spaceId}/revisions/{revisionId}/changes)

Inputs: spaceId (required), revisionId (required), body.

gitbook_get_spaceGet a spaceA
Read-onlyIdempotent

Fetch a single space by id (title, visibility, urls, default revision).

Inputs: spaceId (required).

gitbook_get_space_pdfGet a URL of the content of a space as PDFA
Read-onlyIdempotent

Get a URL of the content of a space as PDF. (GET /spaces/{spaceId}/pdf)

Inputs: spaceId (required), body.

gitbook_get_user_by_idGet a user by its IDB
Read-onlyIdempotent

Get a user by its ID. (GET /users/{userId})

Inputs: userId (required).

gitbook_import_contentImport content into a change requestA

GitBook's content-write primitive: import a public web page (sourceUrl) into a space — scoped to a change request (and optionally a page), AI-enhanced by default. There is NO direct 'set page body' API; this is the supported write path. The import is asynchronous (returns a run id + status); review in GitBook, then gitbook_merge_change_request to publish.

Inputs: orgId (required), spaceId (required), sourceUrl (required), changeRequestId, +2 more.

gitbook_list_change_requests_for_organizationList all change requests in an organizationB
Read-onlyIdempotent

List all change requests in an organization. (GET /orgs/{organizationId}/change-requests)

Inputs: organizationId (required), body.

gitbook_list_change_requests_for_spaceList all change requestsB
Read-onlyIdempotent

List all change requests. (GET /spaces/{spaceId}/change-requests)

Inputs: spaceId (required), body.

gitbook_list_commenters_in_change_requestList all users who commented in a CRA
Read-onlyIdempotent

List all users who commented in a CR. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/commenters)

Inputs: spaceId (required), changeRequestId (required), body.

gitbook_list_commenters_in_spaceList all users who commented in a spaceA
Read-onlyIdempotent

List all users who commented in a space. (GET /spaces/{spaceId}/commenters)

Inputs: spaceId (required), body.

gitbook_list_comment_replies_in_change_requestList all change request comment repliesA
Read-onlyIdempotent

List all change request comment replies. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/comments/{commentId}/replies)

Inputs: spaceId (required), changeRequestId (required), commentId (required), body.

gitbook_list_comment_replies_in_spaceList all space comment repliesB
Read-onlyIdempotent

List all space comment replies. (GET /spaces/{spaceId}/comments/{commentId}/replies)

Inputs: spaceId (required), commentId (required), body.

gitbook_list_comments_in_change_requestList all change request commentsA
Read-onlyIdempotent

List all change request comments. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/comments)

Inputs: spaceId (required), changeRequestId (required), body.

gitbook_list_comments_in_spaceList all space commentsA
Read-onlyIdempotent

List all space comments. (GET /spaces/{spaceId}/comments)

Inputs: spaceId (required), body.

gitbook_list_filesList all space filesA
Read-onlyIdempotent

List all space files. (GET /spaces/{spaceId}/content/files)

Inputs: spaceId (required), body.

gitbook_list_files_in_change_request_by_idList all change request filesA
Read-onlyIdempotent

List all change request files. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/content/files)

Inputs: spaceId (required), changeRequestId (required), body.

gitbook_list_files_in_revision_by_idList all space revision filesA
Read-onlyIdempotent

List all space revision files. (GET /spaces/{spaceId}/revisions/{revisionId}/files)

Inputs: spaceId (required), revisionId (required), body.

gitbook_list_orgsList organizationsA
Read-onlyIdempotent

List organizations the authenticated user can access. Use the returned id as orgId for other tools.

Inputs: limit, cursor.

gitbook_list_pagesList pages in a spaceA
Read-onlyIdempotent

List the page tree of a space's current revision (page ids, titles, paths). Not paginated.

Inputs: spaceId (required).

gitbook_list_pages_in_change_requestList all change request pagesA
Read-onlyIdempotent

List all change request pages. (GET /spaces/{spaceId}/change-requests/{changeRequestId}/content/pages)

Inputs: spaceId (required), changeRequestId (required), body.

gitbook_list_pages_in_revision_by_idList all pages in a space revisionA
Read-onlyIdempotent

List all pages in a space revision. (GET /spaces/{spaceId}/revisions/{revisionId}/pages)

Inputs: spaceId (required), revisionId (required), body.

gitbook_list_spacesList spaces in an organizationA
Read-onlyIdempotent

List the spaces inside an organization. Get orgId from gitbook_list_orgs.

Inputs: orgId (required), limit, cursor.

gitbook_merge_change_requestMerge (publish) a change requestA
Destructive

Publish a change request into the live space. THIS IS DESTRUCTIVE — it changes the live published docs. Only call after the change request has been reviewed.

Inputs: spaceId (required), changeRequestId (required).

gitbook_move_spaceMove a space to a new positionB

Move a space to a new position. (POST /spaces/{spaceId}/move)

Inputs: spaceId (required), body.

gitbook_post_comment_in_spaceCreate a space commentC

Create a space comment. (POST /spaces/{spaceId}/comments)

Inputs: spaceId (required), body.

gitbook_post_comment_reply_in_change_requestCreate a change request comment replyB

Create a change request comment reply. (POST /spaces/{spaceId}/change-requests/{changeRequestId}/comments/{commentId}/replies)

Inputs: spaceId (required), changeRequestId (required), commentId (required), body.

gitbook_post_comment_reply_in_spaceCreate a space comment replyB

Create a space comment reply. (POST /spaces/{spaceId}/comments/{commentId}/replies)

Inputs: spaceId (required), commentId (required), body.

gitbook_request_reviewers_for_change_requestRequest change request reviewersC

Request change request reviewers. (POST /spaces/{spaceId}/change-requests/{changeRequestId}/requested-reviewers)

Inputs: spaceId (required), changeRequestId (required), body.

gitbook_restore_spaceRestore a deleted spaceB

Restore a deleted space. (POST /spaces/{spaceId}/restore)

Inputs: spaceId (required).

gitbook_submit_change_request_reviewSubmit a change request reviewC

Submit a change request review. (POST /spaces/{spaceId}/change-requests/{changeRequestId}/reviews)

Inputs: spaceId (required), changeRequestId (required), body.

gitbook_update_change_requestPull primary content into the change requestA

Pull primary content into the change request. (POST /spaces/{spaceId}/change-requests/{changeRequestId}/update)

Inputs: spaceId (required), changeRequestId (required).

gitbook_update_change_request_by_idUpdate a change requestB

Update a change request. (PATCH /spaces/{spaceId}/change-requests/{changeRequestId})

Inputs: spaceId (required), changeRequestId (required), body.

gitbook_update_comment_in_change_requestUpdate a change request commentB

Update a change request comment. (PUT /spaces/{spaceId}/change-requests/{changeRequestId}/comments/{commentId})

Inputs: spaceId (required), changeRequestId (required), commentId (required), body.

gitbook_update_comment_in_spaceUpdate a space commentB

Update a space comment. (PUT /spaces/{spaceId}/comments/{commentId})

Inputs: spaceId (required), commentId (required), body.

gitbook_update_comment_reply_in_change_requestUpdate a change request comment replyC

Update a change request comment reply. (PUT /spaces/{spaceId}/change-requests/{changeRequestId}/comments/{commentId}/replies/{commentReplyId})

Inputs: spaceId (required), changeRequestId (required), commentId (required), commentReplyId (required), +1 more.

gitbook_update_comment_reply_in_spaceUpdate a space comment replyB

Update a space comment reply. (PUT /spaces/{spaceId}/comments/{commentId}/replies/{commentReplyId})

Inputs: spaceId (required), commentId (required), commentReplyId (required), body.

gitbook_update_space_by_idUpdate a spaceC

Update a space. (PATCH /spaces/{spaceId})

Inputs: spaceId (required), body.

gitbook_update_user_by_idUpdate a user by its IDB

Update a user by its ID. (PATCH /users/{userId})

Inputs: userId (required), body.

gitbook_whoamiGet authenticated userA
Read-onlyIdempotent

Return the GitBook user the configured token authenticates as (id, name, email).

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.2/5.0

    Scored across 89 tools

    Disambiguation3/5

    Many tools have similar names (e.g., list_*_backlinks for different scopes), but descriptions help differentiate. However, with 89 tools, the sheer volume makes it hard for an agent to quickly select the right one, especially without clear categorization.

    Naming Consistency5/5

    All tools adhere to a strict 'gitbook_verb_noun' pattern, with consistent use of prepositions like 'in', 'by', 'for'. No mixing of conventions, making the naming predictable across the entire set.

    Tool Count2/5

    89 tools is excessive for a documentation tool. Many tools handle granular sub-resources (e.g., backlinks, meta-links in specific contexts) that could be consolidated. This makes the surface feel bloated and hard to navigate.

    Completeness3/5

    Covers most read and manage operations for spaces, change requests, comments, and files. However, direct content creation/editing is limited to an asynchronous import tool; no create/update page or document body tools exist, leaving a notable gap.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      A Model Context Protocol server for Git repository interaction and automation. This server provides tools to read, search, and manipulate Git repositories via Large Language Models.
      14
      97,509 PyPI
      92,139
      MIT
    • -
      license
      C
      quality
      Not graded
      maintenance
      A Model Context Protocol server with GitHub API integration that enables interaction with repositories, issues, pull requests, and file management through a standardized interface.
      1
      -