bookstack

This MCP server connects BookStack to Claude and other AI assistants using the Model Context Protocol (MCP). It exposes 47+ MCP tools that cover complete BookStack operations, including managing books, pages, chapters, shelves, users, roles, permissions, and more. You can perform CRUD operations on resources, search across content, manage attachments, and export data in multiple formats. To use it with Claude, add the MCP integration and provide your BookStack instance URL and an API token so Claude can access your content securely. The server is designed with rate limiting, validation, error handling, and logging to ensure stable production use. The included tools are organized into categories like Books, Pages, Chapters, Shelves, Users & Roles, Search, Attachments, Permissions, Recycle Bin, Audit Log, and System Info, giving you comprehensive control over your knowledge base.

Prerequisites:

• Node.js and npm installed on your system
• Access to a BookStack instance with an API token
• Optional: Cloud or server environment to run the MCP server continuously

Installation steps:

1. Install the MCP server package globally (or you can run it via npx without installing):

   npm install -g bookstack-mcp-server

2. Start the server directly (as a quick test):

   npx bookstack-mcp-server

3. If you prefer to run via npm script or inside a project, you can install locally:

   npm install bookstack-mcp-server --save npx bookstack-mcp-server

4. Set up environment variables for BookStack access (see configuration below) and ensure your BookStack instance is reachable from where you run the MCP server.

Environment variables are critical for connecting to BookStack. Ensure BOOKSTACK_BASE_URL points to the BookStack API root (e.g., https://your-bookstack.com/api) and BOOKSTACK_API_TOKEN is a valid token in the format token_id:token_secret. If you encounter connectivity or permission issues, verify that the API token has sufficient scopes and that CORS or network restrictions allow the MCP server to communicate with BookStack. For production deployments, consider running with a process manager (e.g., systemd, PM2) and enabling proper logging and rate limiting. The docs folder provides Setup Guide, API Reference, Tools Overview, and more for advanced configuration and usage.