Bookstack MCP Server
A Model Context Protocol (MCP) server providing full access to BookStack's knowledge management capabilities
Installation
npx bookstack-mcp-serverAsk AI about Bookstack MCP Server
Powered by Claude Β· Grounded in docs
I know everything about Bookstack MCP Server. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Reviews
Documentation
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-server
Add 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=stdio
Configuration
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
