BookStack

Provides BookStack content and image gallery management via FastMCP with support for image uploads and Letta-compatible operations.

python

8

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "oculairmedia-bookstack-mcp": {
      "command": "python3",
      "args": [
        "-m",
        "fastmcp_server"
      ],
      "env": {
        "BS_URL": "https://your-bookstack.example.com",
        "BS_TOKEN_ID": "...REPLACE_ME...",
        "BS_TOKEN_SECRET": "...REPLACE_ME..."
      }
    }
  }
}

You run a BookStack MCP Server that exposes consolidated tools for managing a BookStack instance through the FastMCP protocol. This server focuses on image gallery workflows to support authoring experiences in MCP clients, enabling unified content and image management from a single interface.

How to use

You interface with the BookStack MCP Server using an MCP client that communicates over the FastMCP protocol. The server provides a set of tools to manage BookStack content and the image gallery, so you can create, read, update, and delete books, chapters, pages, and images from your MCP client. Use the server to script repetitive tasks, automate image uploads to the gallery, and perform bulk operations on your BookStack content.

How to install

Prerequisites: you need Python installed on your system. You will also install dependencies listed for the FastMCP server.

pip install -r fastmcp_server/requirements.txt

Additional setup and usage notes

Prepare environment variables for BookStack access. Create a file named .env in the server directory with these values:

BS_URL=https://your-bookstack.example.com
BS_TOKEN_ID=...
BS_TOKEN_SECRET=...

Starting the server

After you have installed dependencies and prepared the environment, start the FastMCP server from its directory.

cd fastmcp_server
python3 -m fastmcp_server

Available tools

bookstack_content_crud

Unified CRUD operations for books, bookshelves, chapters, and pages (Letta-compatible)

bookstack_list_content

List and filter content entities with pagination

bookstack_search

Full-text search across BookStack content

bookstack_batch_operations

Bulk create, update, and delete operations on content

bookstack_manage_images

Unified create/read/update/delete/list interface for images in the image gallery

bookstack_search_images

Advanced discovery with filters for images by extension, date, size, and usage