Provides comprehensive tools for managing BookStack content including searching across books, pages, and chapters, creating and updating pages, retrieving detailed information about books and chapters, and exporting pages in various formats (HTML, PDF, Markdown, Plain text).
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BookStack MCP Serversearch for pages about API documentation"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BookStack MCP Server
A Model Context Protocol (MCP) server that gives AI assistants full access to your BookStack documentation — search, read, create, and manage content.
Features
17 read-only tools + 8 write tools for complete BookStack API coverage
Type-safe input validation with Zod (auto-coerces string/number params for broad client compatibility)
Embedded URLs and content previews in all responses
Write operations disabled by default for safety
Works with Claude Desktop, LibreChat, and any MCP-compatible client
Related MCP server: PDF RAG MCP Server
Quick Start
Install from npm
npx bookstack-mcpOr clone and build
git clone https://github.com/ttpears/bookstack-mcp.git
cd bookstack-mcp
npm install && npm run build
npm startEnvironment Variables
BOOKSTACK_BASE_URL=https://your-bookstack.com # Required
BOOKSTACK_TOKEN_ID=your-token-id # Required
BOOKSTACK_TOKEN_SECRET=your-token-secret # Required
BOOKSTACK_ENABLE_WRITE=false # Optional, default falseClient Configuration
Claude Desktop
Add to your Claude Desktop config:
{
"mcpServers": {
"bookstack": {
"command": "npx",
"args": ["-y", "bookstack-mcp"],
"env": {
"BOOKSTACK_BASE_URL": "https://your-bookstack.com",
"BOOKSTACK_TOKEN_ID": "your-token-id",
"BOOKSTACK_TOKEN_SECRET": "your-token-secret"
}
}
}
}LibreChat
Add to your librechat.yaml:
mcpServers:
bookstack:
command: npx
args:
- -y
- bookstack-mcp
env:
BOOKSTACK_BASE_URL: "https://your-bookstack.com"
BOOKSTACK_TOKEN_ID: "your-token-id"
BOOKSTACK_TOKEN_SECRET: "your-token-secret"Restart LibreChat after config changes.
Available Tools
Read Operations (always available)
Tool | Description |
| Server capabilities and configuration |
| Search across all content with filtering |
| Search pages with optional book filtering |
| List or get details of books |
| List or get full page content |
| List or get chapter details |
| List or get shelf details |
| List or get attachment details |
| Export page as HTML, PDF, Markdown, plaintext, or ZIP |
| Export entire book |
| Export chapter |
| Recently updated content |
Write Operations (requires BOOKSTACK_ENABLE_WRITE=true)
Tool | Description |
| Create or update pages |
| Manage shelves |
| Manage attachments |
BookStack API Setup
Log into BookStack as an admin
Go to Settings > Users > Edit your user
Ensure the user has Access System API permission
In the API Tokens section, create a new token
Copy the Token ID and Token Secret
Security
Write operations are disabled by default
Use HTTPS for production instances
Store API tokens securely (never commit to git)
Consider a dedicated BookStack user with limited permissions
Development
npm run dev # Hot reload with tsx
npm run type-check # Type checking only
npm run build # Production buildLicense
MIT
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.