Connect an AI assistant to your BookStack wiki to search documentation, summarize books, and manage pages and content.
Also known as ttpears/bookstack-mcp
- Stars
- 56
- Tools
- —
- Downloads, 30 days
- —
- Latest version
- —
- Last commit
- Nov 15, 2026
- License
- MIT
What is BookStack MCP?
BookStack connects an AI assistant to your BookStack wiki to search documentation, summarize books, and manage pages and content.
Summary generated from the project's README
About BookStack MCP server
Connecting an AI assistant to your BookStack wiki allows for searching documentation, summarizing books, and managing content directly through a chat interface. This server works with various clients including Claude Desktop, Claude Code, Cursor, and Gemini CLI. It functions as a read-only tool by default, providing 21 tools for browsing books, chapters, pages, and attachments, but can be configured with 22 additional write tools to enable content maintenance.
To set up the connection, you must provide a BookStack base URL, a Token ID, and a Token Secret from a dedicated BookStack account. Users can choose between local stdio configurations or remote HTTP deployments. For those needing to modify content, enabling write access requires setting a specific environment variable and using a token with appropriate permissions. The server also supports exporting content as Markdown, HTML, or PDF to help the assistant process information accurately.
What you can do with it
- 1Search and link documentationAsk your AI to find specific onboarding guides or documentation within your wiki and provide direct links.
- 2Summarize wiki contentRequest a concise summary of an entire book or specific chapters stored in BookStack.
- 3Maintain and update pagesUse the assistant to create, update, or delete wiki pages and manage gallery image uploads.
Written from the project's README. Every use case is checked against a quote from it.
How to install BookStack MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall BookStack MCP in Claude Code
$ claude mcp add bookstack-mcp -- npx -y bookstack-mcpInstall BookStack MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"bookstack-mcp": {
"command": "npx",
"args": [
"-y",
"bookstack-mcp"
]
}
}
}Install BookStack MCP in VS Code
.vscode/mcp.json
{
"servers": {
"bookstack-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"bookstack-mcp"
]
}
}
}Install BookStack MCP in VS Code CLI
$ code --add-mcp '{"name":"bookstack-mcp","type":"stdio","command":"npx","args":["-y","bookstack-mcp"]}'Install BookStack MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"bookstack-mcp": {
"command": "npx",
"args": [
"-y",
"bookstack-mcp"
]
}
}
}Install BookStack MCP in Codex
$ codex mcp add bookstack-mcp -- npx -y bookstack-mcpInstall BookStack MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.bookstack-mcp] command = "npx" args = ["-y", "bookstack-mcp"]
Install BookStack MCP in Gemini CLI
$ gemini mcp add -s user bookstack-mcp npx -- -y bookstack-mcpInstall BookStack MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"bookstack-mcp": {
"command": "npx",
"args": [
"-y",
"bookstack-mcp"
]
}
}
}Configuration
BOOKSTACK_BASE_URLBOOKSTACK_TOKEN_IDBOOKSTACK_TOKEN_SECRET
| Name | Description | |
|---|---|---|
| BOOKSTACK_BASE_URL | — | |
| BOOKSTACK_TOKEN_ID | — | |
| BOOKSTACK_TOKEN_SECRET | — |
Automated checks
Ran Nov 12, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablePass
- Open source license (OSI)Pass
- Commit or release in the last yearPass
- Package name not close to a popular packagePass
- Remote endpoint uses HTTPSNot checked
- Destructive tools are labelledNot checked
- No hidden instructions to the modelPass
- No critical advisory in the package or its dependenciesNot checked
README
View on GitHubBookStack MCP Server
Connect an AI assistant to your BookStack wiki through the Model Context Protocol. Search documentation, answer questions with source links, summarize books, and optionally maintain pages and other content.
Read-only by default. The server exposes 21 read tools and, when enabled, 22 write tools. BookStack permissions still apply to every API request. Use a dedicated account with access to only the content the assistant should see.
Quick Start
1. Create a BookStack API token
In BookStack, open your profile's API Tokens section and create a token for a dedicated user. Its role needs Access System API and permission to view the relevant books/pages. Copy both the Token ID and Token Secret; they are separate values.
Also grant Export Content to read WYSIWYG pages as Markdown: BookStack stores no Markdown source for those pages, so the server uses its export endpoint as a fallback. User lookup and recycle-bin tools require additional administrative permissions; ordinary reading does not.
2. Choose an installation
| Your setup | Start here |
|---|---|
| Claude Desktop | Install the .mcpb bundle from the latest release under Settings → Extensions, then enter the three BookStack settings |
| Claude Code | Marketplace or direct CLI setup |
| Codex or Gemini CLI | Native plugin and extension setup |
| Cursor | Native plugin or manual MCP setup |
| Any local MCP client | Use the stdio configuration below |
| LibreChat / shared Docker service | Internal HTTP deployment |
| Remote connector with Microsoft sign-in | HTTPS and Entra OAuth deployment |
For npm-based installations, use a supported Node.js LTS release (Node 24 recommended; CI also uses Node 22). The published package declares node >=18; that minimum is not a recommendation to run an unsupported Node release. Docker includes its own Node runtime.
3. Configure a local MCP client
Add this entry to your client's MCP configuration, replacing the example values:
{
"mcpServers": {
"bookstack": {
"command": "npx",
"args": ["-y", "bookstack-mcp@5.7.1"],
"env": {
"BOOKSTACK_BASE_URL": "https://wiki.example.com",
"BOOKSTACK_TOKEN_ID": "your-token-id",
"BOOKSTACK_TOKEN_SECRET": "your-token-secret"
}
}
}
}
This configuration contains credentials: keep it private and outside version control. It pins the reviewed release 5.7.1; update the exact version deliberately when upgrading. The repository's native plugin/extension launchers also pin a matching npm version.
Restart the client, check that BookStack tools appear, and ask: “List the books I can access, then find our onboarding guide and link to it.” This verifies MCP connectivity and BookStack access. Starting npx without the required settings fails; starting it in a terminal with settings waits for MCP input rather than opening a web interface.
Client Configuration
The client guide covers Claude Desktop, Claude Code, Codex, Cursor, Gemini CLI, and LibreChat, including per-user HTTP credential headers. The configuration reference documents all server settings and the different npm and Docker defaults.
For development from a checkout, see CONTRIBUTING.md. The server does not automatically read .env; use the client's env settings, export variables, or explicitly pass Node's --env-file option.
Available Tools
| Task | Tools and behavior |
|---|---|
| Find information | search_content, search_pages, find_users, get_recent_changes |
| Read the wiki | List/detail tools for books, chapters, pages, shelves, attachments, and comments; list_images |
| Export | export_page, export_book, export_chapter as HTML, Markdown, plaintext, PDF, or ZIP |
| Maintain content | Optional create/update/delete tools, gallery image uploads, and recycle-bin operations |
See the complete tool reference and recipes for all 43 tool names, pagination, tags, image policies, and version requirements. MCP tools/list on your connected server is authoritative for argument schemas and enabled tools.
To enable writes in non-OAuth mode, set BOOKSTACK_ENABLE_WRITE=true and use a BookStack token with the corresponding permissions. In OAuth mode, writes instead require the configured Entra role and a separate write-token pair. Entra users normally share those BookStack service accounts; sign-in does not automatically give each user their own BookStack identity or private content boundary.
Editing pages safely
- For HTML/WYSIWYG pages, read
get_pagewithformat: "raw"and update usinghtml. The renderedhtmlview can remove editor attributes and resolve includes. - For Markdown pages, read
format: "markdown"and update usingmarkdown. Savinghtmlclears the stored Markdown source. - Tags replace the entire tag list. Omit
tagsto preserve it, or send[]to clear it. Read the current list before changing individual tags. - Read all content chunks before replacing a large page. Worked examples show the workflow.
MCP Resources
Clients with resource support can browse bookstack://book/{id} for book metadata and bookstack://page/{id} for Markdown and page metadata. Both templates provide ID completion through BookStack search.
Four MCP prompts guide read workflows: answer_from_wiki, find_pages, summarize_book, and recent_changes. Prompt arguments are documented alongside the tools. Client support for resources and prompts varies.
Security
Use HTTPS, keep TLS verification enabled, and protect HTTP services with OAuth or a trusted internal network. HTTP without OAuth has no built-in caller authentication. Set an explicit allowed-host list when exposing a container; a host allowlist is not authentication.
HTTP image downloads require an allowed hostname, and local file uploads are disabled by default. Request bodies, request duration, and session counts are bounded. See deployment boundaries and the security policy, including private vulnerability reporting.
The privacy policy explains data flows, credentials, OAuth/Redis state, and logging. Your AI client and deployment operator may have additional policies. Use is governed by the terms and MIT license.
Documentation
Browse the documentation index for installation, deployment, configuration, tool recipes, troubleshooting, contributions, releases, and HOL Guard. For a connection problem, start with the troubleshooting guide.
Design background: Why my BookStack MCP server starts read-only describes permission boundaries, shared-token rate limiting, and response-size decisions.
BookStack MCP questions
How do I add BookStack MCP to Claude Code?
Run claude mcp add bookstack-mcp -- npx -y bookstack-mcp in your terminal. Add --scope user to make it available in every project.
How do I add BookStack MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
Is the server read-only by default?
Yes, the server is read-only by default, exposing 21 read tools. Write tools can be enabled by setting the BOOKSTACK_ENABLE_WRITE environment variable.
How do I provide access to the AI assistant?
You need to create a BookStack API token in your profile's API Tokens section, ensuring the user has 'Access System API' and relevant permissions.
Can the server read WYSIWYG pages as Markdown?
Yes, if you grant the 'Export Content' permission, the server can use the export endpoint as a fallback to read WYSIWYG pages as Markdown.