# GitBook MCP by usefulapi

> GitBook MCP by usefulapi is an MCP server. Read spaces, collections, pages and content; search docs and manage GitBook organization spaces. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/gitbook/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/gitbook
- **MCP Registry name:** io.usefulapi/gitbook
- **Listing updated:** 2026-11-13

## About

Read spaces, collections, pages and content; search docs and manage GitBook organization spaces.

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http gitbook https://gitbook.usefulapi.io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gitbook.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gitbook": {
      "url": "https://gitbook.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gitbook": {
      "type": "http",
      "url": "https://gitbook.usefulapi.io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gitbook": {
      "serverUrl": "https://gitbook.usefulapi.io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gitbook": {
      "type": "http",
      "url": "https://gitbook.usefulapi.io/mcp"
    }
  }
}
```

## Tools

- `gitbook_get_current_user`: Get the profile of the authenticated GitBook user. GitBook REST: GET /user.
- `gitbook_list_organizations`: List the organizations the authenticated user belongs to. GitBook REST: GET /orgs.
- `gitbook_list_spaces`: List all spaces in an organization. GitBook REST: GET /orgs/{organizationId}/spaces.
- `gitbook_get_space`: Get full details of a space by its ID. GitBook REST: GET /spaces/{spaceId}.
- `gitbook_list_pages`: List all pages in a space with their hierarchy and metadata. GitBook REST: GET /spaces/{spaceId}/content/pages.
- `gitbook_get_page`: Get a single page's content from a space by its page ID. GitBook REST: GET /spaces/{spaceId}/content/page/{pageId}.
- `gitbook_search_space`: Full-text search across all pages in a space. GitBook REST: GET /spaces/{spaceId}/search.
- `gitbook_search_organization`: Search content across an entire organization. GitBook REST: GET /orgs/{organizationId}/search.
- `gitbook_list_collections`: List all collections in an organization. GitBook REST: GET /orgs/{organizationId}/collections.
- `gitbook_get_collection`: Get a collection by its ID. GitBook REST: GET /collections/{collectionId}.
- `gitbook_list_change_requests`: List change requests for a space. GitBook REST: GET /spaces/{spaceId}/change-requests.
- `gitbook_list_comments`: List top-level comments posted on a space. GitBook REST: GET /spaces/{spaceId}/comments.
- `gitbook_create_change_request`: Create a new draft change request (branch) in a space. Safe: creates a draft; publishes nothing. GitBook REST: POST /spaces/{spaceId}/change-requests.
- `gitbook_update_change_request`: Update a change request's subject or status. Edits draft metadata only. GitBook REST: PATCH /spaces/{spaceId}/change-requests/{changeRequestId}.

## FAQ

### How do I add GitBook MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http gitbook https://gitbook.usefulapi.io/mcp

---
Source: https://ai-powered.com/mcp/gitbook-mcp-by-usefulapi
