bookstack

The BookStack MCP Server provides a production-ready interface for AI assistants to manage and interact with a BookStack knowledge base. It exposes a set of tools to create, read, update, and delete pages, books, and related content, along with advanced discovery and metadata capabilities. With features like name-to-ID resolution, hierarchical navigation, and context-aware targeting, you can perform complex operations across books, chapters, and pages using both IDs and human-friendly names. To integrate with Claude Desktop or similar clients, configure an MCP entry that points to the Node.js server build, along with BookStack credentials to authorize API calls.

Once running, you can leverage the available tools to perform tasks such as creating and updating pages, discovering content with search and filters, and managing books and shelves. For example, create a page by providing a page name, content in HTML or Markdown, and the target book, or read a book by ID or name to fetch its details. The server handles token-based authentication, input validation, and error handling to provide reliable, enterprise-grade interactions with your BookStack instance.

Prerequisites:

• Node.js 20+ installed on the host
• Docker and Docker Compose (optional for containerized deployment)
• Access to a BookStack instance with API credentials (URL, Token ID, Token Secret)

Step-by-step installation:

1. Clone the repository:

git clone <repository-url>
cd bookstack-mcp-server

2. Install dependencies:

npm install

3. Configure environment (example .env):

# Create and edit .env with your BookStack credentials
BOOKSTACK_URL="https://your-bookstack-instance.com"
BOOKSTACK_API_TOKEN_ID="your_token_id"
BOOKSTACK_API_TOKEN_SECRET="your_token_secret"

4. Build and run (local development):

# Development with hot reload (if scripts are set up)
npm run watch
# Or production build and start
npm run build
npm start

5. Optional: Docker deployment

# Build and start containers with docker-compose (example)
docker-compose up --build -d

6. Verify:

• Ensure the server is reachable at the configured host/port.
• Check BookStack integration by performing a simple create/read operation via the MCP tooling.

Environment variables: Ensure BOOKSTACK_URL, BOOKSTACK_API_TOKEN_ID, and BOOKSTACK_API_TOKEN_SECRET are kept secure. When running in Docker, prefer non-root user execution and follow the container health checks and log rotation guidelines described in the README. If you encounter authentication errors, double-check your BookStack API tokens and API endpoint URL. For production deployments, consider using Docker Compose or Kubernetes with proper secret management and health monitoring. The server supports both IDs and names for identifying resources, and it performs automatic name-to-ID resolution to simplify commands.