bookstack-mcp-server

pnocera/bookstack-mcp-server

3.3

If you are the rightful owner of bookstack-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The BookStack MCP Server is a comprehensive Model Context Protocol server that provides full access to BookStack's knowledge management capabilities, integrating seamlessly with Claude and other MCP-compatible AI assistants.

Tools

  1. bookstack_books_list

    List all books with filtering

  2. bookstack_books_create

    Create new books

  3. bookstack_books_read

    Get book details with contents

  4. bookstack_books_update

    Update book information

  5. bookstack_books_delete

    Delete books (to recycle bin)

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

🛠️ 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 for detailed documentation

📚 Documentation

Find comprehensive guides in the docs/ folder:

  • - Complete installation and configuration
  • - All endpoints with examples
  • - Every tool explained
  • - Resource access patterns
  • - 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 for development, Docker, and production deployment

📝 License

MIT License - see 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

Built with ❤️ for the BookStack community