Skip to content

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.

Deletes · 2

14 tools: 2 can delete or cancel things and 12 only read.

Scanned Oct 21, 2026

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/mcp

Tools

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/mcp

Run in a terminal.

Claude Code permissions

Allow the reads, ask before a change, deny the deletes. Paste into .claude/settings.json.

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