GitBook MCP by usefulapi
by usefulapi.io · remote · no sign-in to list tools · v1.16.3 · published by io.usefulapi
Read spaces, collections, pages and content; search docs and manage GitBook organization spaces.
14 tools: 2 can delete or cancel things and 12 only read.
Scanned Oct 21, 2026
- Deletes or cancels2Claude Code: deny: see these tools
- Can't be undone0Claude Code: ask
- Changes things0Claude Code: ask
- Only reads12Claude Code: allow: see these tools
No check matched anything in the tool definitions. No finding is not a safety guarantee. How the checks work.
claude mcp add --transport http gitbook https://gitbook.usefulapi.io/mcpTools
Open a tool for its reasons and full description. Descriptions are the publisher's own words, shown as they are.
14 tools
Deletes or cancels 2Claude Code: deny
gitbook_create_change_requestCreate a new draft change request (branch) in a space.No findings
Why it is in this group
- The name "gitbook_create_change_request" says "create": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Create a new draft change request (branch) in a space. Safe: creates a draft; publishes nothing. GitBook REST: POST /spaces/{spaceId}/change-requests.
Annotations the server declares
- title: Create change request
- destructiveHint: true
gitbook_update_change_requestUpdate a change request's subject or status.No findings
Why it is in this group
- The name "gitbook_update_change_request" says "update": a word for a change.
- The server marks it destructive (destructiveHint: true).
Description, as the server wrote it Update a change request's subject or status. Edits draft metadata only. GitBook REST: PATCH /spaces/{spaceId}/change-requests/{changeRequestId}.
Annotations the server declares
- title: Update change request
- destructiveHint: true
Only reads 12Claude Code: allow
gitbook_get_collectionGet a collection by its ID.No findings
Why it is in this group
- The name "gitbook_get_collection" says "get": a word for reading.
Description, as the server wrote it Get a collection by its ID. GitBook REST: GET /collections/{collectionId}.
Annotations the server declares
- title: Get collection
- readOnlyHint: true
gitbook_get_current_userGet the profile of the authenticated GitBook user.No findings
Why it is in this group
- The name "gitbook_get_current_user" says "get": a word for reading.
Description, as the server wrote it Get the profile of the authenticated GitBook user. GitBook REST: GET /user.
Annotations the server declares
- title: Get current user
- readOnlyHint: true
gitbook_get_pageGet a single page's content from a space by its page ID.No findings
Why it is in this group
- The name "gitbook_get_page" says "get": a word for reading.
Description, as the server wrote it Get a single page's content from a space by its page ID. GitBook REST: GET /spaces/{spaceId}/content/page/{pageId}.
Annotations the server declares
- title: Get page
- readOnlyHint: true
gitbook_get_spaceGet full details of a space by its ID.No findings
Why it is in this group
- The name "gitbook_get_space" says "get": a word for reading.
Description, as the server wrote it Get full details of a space by its ID. GitBook REST: GET /spaces/{spaceId}.
Annotations the server declares
- title: Get space
- readOnlyHint: true
gitbook_list_change_requestsList change requests for a space.No findings
Why it is in this group
- The name "gitbook_list_change_requests" says "list": a word for reading.
Description, as the server wrote it List change requests for a space. GitBook REST: GET /spaces/{spaceId}/change-requests.
Annotations the server declares
- title: List change requests
- readOnlyHint: true
gitbook_list_collectionsList all collections in an organization.No findings
Why it is in this group
- The name "gitbook_list_collections" says "list": a word for reading.
Description, as the server wrote it List all collections in an organization. GitBook REST: GET /orgs/{organizationId}/collections.
Annotations the server declares
- title: List collections
- readOnlyHint: true
gitbook_list_commentsList top-level comments posted on a space.No findings
Why it is in this group
- The name "gitbook_list_comments" says "list": a word for reading.
Description, as the server wrote it List top-level comments posted on a space. GitBook REST: GET /spaces/{spaceId}/comments.
Annotations the server declares
- title: List comments
- readOnlyHint: true
gitbook_list_organizationsList the organizations the authenticated user belongs to.No findings
Why it is in this group
- The name "gitbook_list_organizations" says "list": a word for reading.
Description, as the server wrote it List the organizations the authenticated user belongs to. GitBook REST: GET /orgs.
Annotations the server declares
- title: List organizations
- readOnlyHint: true
gitbook_list_pagesList all pages in a space with their hierarchy and metadata.No findings
Why it is in this group
- The name "gitbook_list_pages" says "list": a word for reading.
Description, as the server wrote it List all pages in a space with their hierarchy and metadata. GitBook REST: GET /spaces/{spaceId}/content/pages.
Annotations the server declares
- title: List pages
- readOnlyHint: true
gitbook_list_spacesList all spaces in an organization.No findings
Why it is in this group
- The name "gitbook_list_spaces" says "list": a word for reading.
Description, as the server wrote it List all spaces in an organization. GitBook REST: GET /orgs/{organizationId}/spaces.
Annotations the server declares
- title: List spaces
- readOnlyHint: true
gitbook_search_organizationSearch content across an entire organization.No findings
Why it is in this group
- The name "gitbook_search_organization" says "search": a word for reading.
Description, as the server wrote it Search content across an entire organization. GitBook REST: GET /orgs/{organizationId}/search.
Annotations the server declares
- title: Search organization
- readOnlyHint: true
gitbook_search_spaceFull-text search across all pages in a space.No findings
Why it is in this group
- The name "gitbook_search_space" says "search": a word for reading.
Description, as the server wrote it Full-text search across all pages in a space. GitBook REST: GET /spaces/{spaceId}/search.
Annotations the server declares
- title: Search space
- readOnlyHint: true
This is not a safety rating, and no finding is not a safety guarantee. The groups and findings come from fixed checks of the tool definitions the server returned on the date shown, not from its code or what it does when called. How the checks work.
Install
Pinned to version 1.16.3. Values in angle brackets are yours to fill in.
claude mcp add --transport http gitbook https://gitbook.usefulapi.io/mcpRun in a terminal.
Claude Code permissions
Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.
{
"permissions": {
"allow": [
"mcp__gitbook__gitbook_get_current_user",
"mcp__gitbook__gitbook_list_organizations",
"mcp__gitbook__gitbook_list_spaces",
"mcp__gitbook__gitbook_get_space",
"mcp__gitbook__gitbook_list_pages",
"mcp__gitbook__gitbook_get_page",
"mcp__gitbook__gitbook_search_space",
"mcp__gitbook__gitbook_search_organization",
"mcp__gitbook__gitbook_list_collections",
"mcp__gitbook__gitbook_get_collection",
"mcp__gitbook__gitbook_list_change_requests",
"mcp__gitbook__gitbook_list_comments"
],
"ask": [],
"deny": [
"mcp__gitbook__gitbook_create_change_request",
"mcp__gitbook__gitbook_update_change_request"
]
}
}Tools that only read are allowed, tools that change things ask first, tools that delete or cancel are denied. It assumes the server is installed as gitbook. Review it before you use it.