@h4sht/bookstack-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@h4sht/bookstack-mcpCreate a new page in book 1 about using MCP with BookStack."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@h4sht/bookstack-mcp
๐ Claude Code
claude mcp add bookstack -- npx github:h4sht/bookstack-mcpClaude Code will prompt you for:
BOOKSTACK_BASE_URLโ your BookStack API URL (e.g.https://wiki.example.com/api)BOOKSTACK_API_TOKENโ your API token (token_id:token_secret)
Or pass them directly:
claude mcp add bookstack \
--env BOOKSTACK_BASE_URL=https://wiki.example.com/api \
--env BOOKSTACK_API_TOKEN=token_id:token_secret \
-- npx github:h4sht/bookstack-mcpThen use /mcp inside Claude Code to verify it's connected โ
Related MCP server: BookStack MCP Server
๐ ๏ธ What you get (25 tools)
Category | Tools |
๐ Books (6) | list, get, create, update, delete, export |
๐ Chapters (6) | list, get, create, update, delete, export |
๐ Pages (6) | list, get, create, update, delete, export |
๐ Shelves (5) | list, get, create, update, delete |
๐ Search (1) | search across all content |
โ๏ธ System (1) | instance info |
All export_* tools support markdown, html, pdf, plaintext.
โ๏ธ Markdown-powered
BookStack stores pages as HTML but accepts Markdown input through its API. This means Claude can create and edit wiki pages in its native format:
"Create a page about async Python in book 3"
โ bookstack_create_page({
book_id: 3,
name: "Async Python Guide",
markdown: "# Async Python\n\n`asyncio` is Python's standard library..."
})Pages are also exported as Markdown, so Claude can read, analyze, and improve existing content.
๐ฆ Setup for other AI assistants
OpenAI Codex
codex mcp add bookstack \
--env BOOKSTACK_BASE_URL=https://wiki.example.com/api \
--env BOOKSTACK_API_TOKEN=id:secret \
-- npx github:h4sht/bookstack-mcpOr add this to ~/.codex/config.toml:
[mcp_servers.bookstack]
command = "npx"
args = ["github:h4sht/bookstack-mcp"]
[mcp_servers.bookstack.env]
BOOKSTACK_BASE_URL = "https://wiki.example.com/api"
BOOKSTACK_API_TOKEN = "id:secret"Verify with: codex mcp list
OpenCode
opencode mcp add
# Select "local", then enter: npx github:h4sht/bookstack-mcpOr add to opencode.json:
{
"mcp": {
"bookstack": {
"type": "local",
"command": ["npx", "github:h4sht/bookstack-mcp"],
"enabled": true,
"environment": {
"BOOKSTACK_BASE_URL": "https://wiki.example.com/api",
"BOOKSTACK_API_TOKEN": "id:secret"
}
}
}
}Cline (VS Code)
Add to Cline MCP settings file:
{
"mcpServers": {
"bookstack": {
"command": "npx",
"args": ["github:h4sht/bookstack-mcp"],
"env": {
"BOOKSTACK_BASE_URL": "https://wiki.example.com/api",
"BOOKSTACK_API_TOKEN": "id:secret"
}
}
}
}Any MCP-compatible assistant (stdio)
The server command is always the same:
npx github:h4sht/bookstack-mcpSet BOOKSTACK_BASE_URL and BOOKSTACK_API_TOKEN as environment variables.
๐ง Config reference
Variable | Required | Description |
| Yes | Full URL including |
| Yes | Format: |
| No | Request timeout ms (default: |
๐ Security
4 auditable files โ read the whole source in 10 minutes
One dependency โ only
@modelcontextprotocol/sdk(official Anthropic)Native fetch() โ no HTTP libraries, no hidden requests
Stdio only โ no open ports, no network surface
Zero telemetry โ no analytics, no tracking, no calls home
Stderr logging โ never writes to stdout (MCP protocol integrity)
๐งช Tests
npm test # 32 tests, all passing โ
๐ Structure
@h4sht/bookstack-mcp/
โโโ src/
โ โโโ index.ts # MCP server, stdio transport, config
โ โโโ client.ts # BookStack REST client (native fetch)
โ โโโ tools.ts # 25 MCP tool definitions + handlers
โ โโโ types.ts # TypeScript types
โโโ dist/ # Compiled JS (ready to run)
โโโ tests/ # 32 unit + integration tests
โโโ package.json
โโโ README.md๐ License
MIT ยฉ h4sht
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseBqualityBmaintenanceEnables interaction with BookStack knowledge management systems through the BookStack API. Supports searching, reading, creating, and updating documentation content with secure authentication and dual transport modes for flexible deployment.1730127MIT
- AlicenseBqualityDmaintenanceEnables AI models to interact with BookStack wiki instances through a comprehensive API interface. Supports content management (books, chapters, pages), user administration, search functionality, and content export in multiple formats.4112MIT
- Flicense-qualityDmaintenanceEnables AI assistants to manage BookStack documentation through natural language, supporting content browsing, search, and CRUD operations for books, chapters, and pages.
- AlicenseBqualityAmaintenanceConnects BookStack knowledge bases to Claude through 47+ tools covering complete CRUD operations for books, pages, chapters, shelves, users, search, attachments, and permissions. Enables full management of BookStack content and configuration through natural language.5620782MIT
Related MCP Connectors
Search and reason over your Obsidian-style Markdown vault, right from ChatGPT.
AI access to your aNotepad online notes: read, search, write, and organize via 22 tools.
Search Stack Exchange questions, fetch Q&A threads as markdown, look up tag FAQs and user profiles.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/h4sht/bookstack-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server