BookStackをモデルコンテキストプロトコル(MCP)を通じてClaudeや他のAIアシスタントに接続できます。このサーバーは、BookStack APIのサポートサブセット(書籍、ページ、章、棚、検索、ユーザー、役割、権限、添付ファイル、画像、ゴミ箱、監査ログ、システム情報)を含む59のツールと11のリソースを公開しています。

このサーバーは2つのトランスポートモードをサポートしています:Streamable HTTP(デフォルト)とStdio。

• ストリーム可能なHTTP(デフォルト):状態のないHTTPトランスポート。認証パラメータはHTTPヘッダー(x-bookstack-urlおよびx-bookstack-token)を使ってリクエストごとにオーバーライド可能です。
• Stdioモード:ローカル統合のための標準入出力(例:Claude Desktopとの接続)。MCP_TRANSPORT=stdioを有効に設定してください。

⚠️ HTTPエンドポイントを探していますか? MCPエンドポイントはPOST /messageであり、/ではありません。 以下の「トランスポートとHTTPエンドポイント」を参照してください。

✨ 何が手に入るか

• BookStack Integration - 書籍、ページ、章、コンテンツへのアクセス
• 59 MCPツール&11リソース - サポートされたエンドポイントファミリー間でのCRUD、検索、エクスポート
• 検索&エクスポート - 複数のフォーマットでコンテンツを見つけてエクスポート
• ユーザー管理 - ユーザー、役割、権限の管理

BookStack MCP Server

Connect BookStack to Claude and other AI assistants through the Model Context Protocol (MCP). This server exposes 59 tools and 11 resources covering the supported subset of the BookStack API — books, pages, chapters, shelves, search, users, roles, permissions, attachments, images, the recycle bin, the audit log and system info.

This server supports two transport modes: Streamable HTTP (default) and Stdio.

• Streamable HTTP (default): A stateless HTTP transport. Authentication parameters can be overridden per-request using HTTP headers (x-bookstack-url and x-bookstack-token).
• Stdio Mode: Standard input/output for local integration (e.g., with Claude Desktop). Set MCP_TRANSPORT=stdio to enable.

⚠️ Looking for the HTTP endpoint? The MCP endpoint is POST /message — not /. See Transports and HTTP endpoints below.

✨ What You Get

• BookStack Integration - Access your books, pages, chapters, and content
• 59 MCP Tools & 11 Resources - CRUD, search and export across the supported endpoint families
• Search & Export - Find content and export in multiple formats
• User Management - Handle users, roles, and permissions
• Production Ready - Rate limiting, validation, error handling, and logging

🚀 Quick Start

⚠️ Requires Bun 1.1.0 or newer. Node.js is not supported. This package ships TypeScript source rather than a compiled bundle, and its executable starts with #!/usr/bin/env bun — Bun must be installed on the machine that runs it. npx/npm install -g will not work.

Configure first — the default HTTP transport refuses to start until both tokens below are set:

# 1. Configure
export BOOKSTACK_BASE_URL="https://your-bookstack.com/api"
export BOOKSTACK_API_TOKEN="token_id:token_secret"   # OUTBOUND: the credential this server spends
export MCP_AUTH_TOKEN="$(openssl rand -hex 32)"      # INBOUND: who may make it spend that credential

# 2. Run without installing (starts the HTTP server on port 3000)
bunx bookstack-mcp-server

# Or install globally, then run it by name
bun add -g bookstack-mcp-server
bookstack-mcp-server

The two tokens are not interchangeable and must not be set to the same value: BOOKSTACK_API_TOKEN is what the server presents to BookStack; MCP_AUTH_TOKEN is what callers must present to POST /message, which dispatches all 59 tools with the authority of the BookStack account behind BOOKSTACK_API_TOKEN. Skip MCP_AUTH_TOKEN only for stdio, which has no network surface and ignores it.

Check it started:

curl http://localhost:3000/          # => {"status":"running", ...}
curl -i http://localhost:3000/health # => 200 healthy, or 503 if BookStack is unreachable

Add to Claude

To use with Claude Desktop (requires Stdio mode):

# For Claude Code
claude mcp add bookstack bunx bookstack-mcp-server \