SkillFoxx

BookStack MCP Server

An MCP server for a BookStack wiki: read and search by default, writes enabled separately, rights taken from the token.

  • 55 ★ on the repository
  • Last commit
  • MIT
MCP server

Extended access

Why this level

  • It reads the BookStack wiki and, with writes enabled, creates and changes pages by API token.
  • The token and secret sit in client environment variables.
All reasons and checks

ttpears/bookstack-mcpAuthor:ttpears

Install

In your terminal, with SkillFoxx CLI

npx skillfoxx add mcp/bookstack-mcp-server

Detects the agents on your machine, shows the access level and pins the version.

Other ways to install

Access and checks

How we review

Extended accessThe tool runs code or makes network calls and only reads external data.

  • It reads the BookStack wiki and, with writes enabled, creates and changes pages by API token.
  • The token and secret sit in client environment variables.

This is third-party code. Review the repository files before installing.

What it does

BookStack MCP Server connects an AI assistant to a BookStack wiki through the Model Context Protocol: documentation search, answers from it and page work. By default the server is read-only: 21 read tools, and 22 write tools appear when enabled. BookStack permissions apply to every API request, so create a dedicated user for the server. To read WYSIWYG editor pages as Markdown, the token needs the Export Content right. Install through an `.mcpb` bundle for Claude Desktop, a plugin for Claude Code, Codex, Cursor and Gemini CLI, or an `npx -y bookstack-mcp` entry in configuration. An internal HTTP service and a remote connector with Microsoft Entra sign-in are available.

Who it is for. Teams that keep documentation in BookStack and want an agent to find answers there and carefully extend pages.

Good fit when

  • An agent answers a question from internal documentation with a page link.
  • The right book and chapter must be found and a page read in full as Markdown.
  • An agent should extend a page after a permission check passes.
  • A shared server is needed for several LibreChat clients inside the network.

Not a fit when

  • The wiki is private and there is no API token for a dedicated user.
  • An agent must be allowed any change with no confirmation.
  • Collaboration is needed with no BookStack server.

Example request

Find the deployment guide in BookStack, read the page in Markdown and list the linked pages.

MCP

Transport
stdio, http
Authentication
API key

Environment variables

BOOKSTACK_BASE_URL required
BookStack wiki URL.
BOOKSTACK_TOKEN_ID required, secret
BookStack API token id.
BOOKSTACK_TOKEN_SECRET required, secret
BookStack API token secret.
BOOKSTACK_ENABLE_WRITE
`true` opens the write tools.

Limitations

A BookStack API token (id and secret) for a user with the Access System API right and permission to view the needed books and pages is required. Writes are off by default, `BOOKSTACK_ENABLE_WRITE=true` opens 22 change tools, and in OAuth mode sign-in rights decide writes. The published package declares `node >=18` but Node 24 or 22 is recommended. For a shared server use internal HTTP or Microsoft Entra sign-in.

How to disable. Delete the `bookstack` entry from client settings, remove the plugin or `.mcpb` extension and revoke the API token in the BookStack profile. The dedicated user can be deleted.

FAQ

Which variables are needed?

`BOOKSTACK_BASE_URL`, `BOOKSTACK_TOKEN_ID` and `BOOKSTACK_TOKEN_SECRET`. Add `BOOKSTACK_ENABLE_WRITE=true` for writes.

How do I install it in Claude Desktop?

Download the `.mcpb` from the latest release, open Settings, Extensions and enter the three BookStack values.

How many tools are there?

21 read tools and 22 write tools when writes are enabled.

Why can't some pages be read as Markdown?

The WYSIWYG editor stores pages with no Markdown source, so the server reads them through export. The token needs the Export Content right.

Can I run a shared server?

Yes: an internal HTTP service for LibreChat or a remote HTTPS connector with Microsoft Entra sign-in.

Discussion

No questions or reviews yet.

MCP servers
Official

The official Kibela MCP server searches, reads and edits notes, folders and comments of your wiki straight from an assistant chat

MCP serverExtended access16

A local reading room for Claude: an EPUB or TXT book is split into chunks, and margin notes and progress persist between sessions.

MCP serverExtended access119

Connects an agent to Nextcloud: notes, calendar, contacts, files, mail and Deck boards through more than 110 MCP tools

MCP serverBroad access411
Official

MCP server for the knowledge base Beever Atlas builds from Slack, Discord, Teams and Mattermost chats: cited answers, channel wikis, a graph

MCP serverBroad access454

An MCP server for WeChat Reading: your AI agent gets your bookshelf, notes, highlights and top reviews

MCP serverBroad access584

README in short

The server adds no permissions of its own: the BookStack access model applies. Different clients have native plugins and a Claude Desktop bundle.

README badge

Report a problem