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.
✨ 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
npx bookstack-mcp-server
Add to Claude
# 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
Configuration
Set these environment variables:
export BOOKSTACK_BASE_URL="https://your-bookstack.com/api"
export BOOKSTACK_API_TOKEN="token_id:token_secret"
💡 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