The BookStack MCP Server connects BookStack knowledge bases to AI assistants via the Model Context Protocol, providing complete CRUD access to all BookStack content and features through 47+ tools.
📚 Books – List, create, read, update, delete, and export in HTML, PDF, plain text, or Markdown
📄 Pages – Full CRUD with HTML or Markdown content; move pages between books/chapters; export in multiple formats
📑 Chapters – Full CRUD; organize pages within books; export content
📚 Shelves – Full CRUD; group books into collections
👥 Users – Manage accounts, roles, passwords, external auth IDs, and migrate content ownership on deletion
🔐 Roles – Full CRUD; configure permissions, MFA enforcement, and display names
🔍 Search – Advanced search across all content types using BookStack's search syntax (phrases, field filters, tags, boolean operators)
📎 Attachments – Manage file attachments or external URL links on pages (with base64 encoding support)
🖼️ Images – List, upload, update, and delete images in the gallery
🔒 Permissions – Read and update granular access control for books, chapters, pages, and shelves by user or role
🗑️ Recycle Bin – List, restore, or permanently delete items
📊 Audit Log – Browse and filter system activity by event type, user, date range, and entity
⚙️ System Info – Retrieve instance health and server information
🤖 LLM Helpers – Access tool categories, workflow examples, error guides, and an interactive help system for AI assistants
The server supports both HTTP (stateless with per-request auth override) and Stdio transport modes, and includes rate limiting, validation, and error handling for production use.
Provides complete access to BookStack knowledge base with 47+ tools covering all API endpoints, including CRUD operations for books, pages, chapters, shelves, user management, search, attachments, permissions, recycle bin, audit logs, and content export in multiple formats.
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 Servercreate a new page in the 'API Documentation' book with the title 'Getting Started'"
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
Connect BookStack to Claude and other AI assistants through the Model Context Protocol (MCP). This server provides complete access to your BookStack knowledge base with 47+ tools covering all API endpoints.
This server supports two transport modes: Streamable HTTP and Stdio.
Streamable HTTP (Default): A stateless HTTP transport. Authentication parameters can be overridden per-request using HTTP headers (
x-bookstack-urlandx-bookstack-token).Stdio Mode: Standard input/output for local integration (e.g., with Claude Desktop). Set
MCP_TRANSPORT=stdioto enable.
✨ What You Get
Complete BookStack Integration - Access all your books, pages, chapters, and content
47+ MCP Tools - Full CRUD operations for every BookStack feature
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
# Install globally
npm install -g bookstack-mcp-server
# Or run directly (starts HTTP server by default)
npx bookstack-mcp-serverAdd to Claude
To use with Claude Desktop (requires Stdio mode):
# For Claude Code
claude mcp add bookstack npx bookstack-mcp-server \
--env BOOKSTACK_BASE_URL=https://your-bookstack.com/api \
--env BOOKSTACK_API_TOKEN=token_id:token_secret \
--env MCP_TRANSPORT=stdioConfiguration
Set these environment variables:
export BOOKSTACK_BASE_URL="https://your-bookstack.com/api"
export BOOKSTACK_API_TOKEN="token_id:token_secret"
# Optional: Set transport mode (http or stdio)
export MCP_TRANSPORT="http" 💡 Token Format: Combine your BookStack Token ID and Token Secret as
token_id:token_secret
💡 Need detailed setup? See the complete Setup Guide
🛠️ Available Tools
47+ tools across 13 categories:
📚 Books - Create, read, update, delete, and export books
📄 Pages - Manage pages with HTML/Markdown content
📑 Chapters - Organize pages within books
📚 Shelves - Group books into collections
👥 Users & Roles - Complete user management
🔍 Search - Advanced search across all content
📎 Attachments & Images - File management
🔐 Permissions - Content access control
🗑️ Recycle Bin - Deleted item recovery
📊 Audit Log - Activity tracking
⚙️ System Info - Instance health and information
📖 See the complete Tools Overview for detailed documentation
📚 Documentation
Find comprehensive guides in the docs/ folder:
Setup Guide - Complete installation and configuration
API Reference - All endpoints with examples
Tools Overview - Every tool explained
Resources Guide - Resource access patterns
Examples & Workflows - Real-world usage
⚡ Quick Examples
List all books:
bookstack_books_list({ count: 10, sort: "updated_at" })Create a new page:
bookstack_pages_create({
name: "Getting Started",
book_id: 1,
markdown: "# Welcome\nYour content here..."
})Search for content:
bookstack_search({ query: "API documentation", count: 20 })🛠️ Development
git clone <repository-url>
cd bookstack-mcp-server
npm install
npm run dev🔧 See the Setup Guide for development, Docker, and production deployment
📝 License
MIT License - see LICENSE file for details.
🌟 Community
This project is part of the BookStack ecosystem! Check out other API-based tools and scripts in the BookStack API Scripts repository.
🆘 Support
📚 Documentation: Complete guides in the docs/ folder
🐛 Issues: GitHub Issues
💬 Discussions: GitHub Discussions
Built with ❤️ for the BookStack community
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.