Handbook
Let your coding agent create, update, search, and organize Handbook API entries instead of clicking the admin UI.
Overview
Handbook MCP is a MCP server for the Build phase that exposes Handbook API CRUD, overview, and tag search to your agent.
What is this MCP server?
- Full handbook entry CRUD through the Handbook API from any MCP client
- Overview and listing tools for scanning what already exists in the handbook
- Tag-based search to find entries by topic without manual browsing
- Configurable API base URL with Bearer token auth (HANDBOOK_API_TOKEN)
- stdio npm package @ah-oh/handbook-mcp-server for Claude Code, Cursor, and similar agents
- Package version 1.0.1 (@ah-oh/handbook-mcp-server)
- stdio transport via npm registry
- 2 environment variables documented (token required, API URL optional)
What problem does it solve?
Updating handbook and internal wiki entries breaks flow when every change means leaving the IDE for a separate admin UI.
Who is it for?
Solo builders or tiny teams using Handbook who want agents to maintain runbooks, specs, and tagged knowledge bases during development.
Skip if: Teams without a Handbook API account, or anyone who only needs a one-off markdown file in the repo.
What do I get? / Deliverables
Your agent can list, search by tag, and mutate handbook entries in place while you document the product.
- Handbook entries created or updated from agent sessions
- Tag-filtered search results and overview lists in the chat
- Synced handbook content aligned with current build docs
Recommended MCP Servers
Journey fit
Handbook content is product and team knowledge you maintain while building; the canonical shelf is documentation workflows during the build phase. CRUD, overview, and tag search map directly to maintaining structured docs and internal handbooks, not shipping or growth.
How it compares
Handbook API integration via MCP, not a static docs skill or markdown linter.
Common Questions / FAQ
Who is Handbook MCP for?
Indie builders and small teams on Handbook who want Claude Code, Cursor, or other MCP clients to manage entries without opening the handbook UI.
When should I use Handbook MCP?
Use it during build and docs work when you need to add, edit, or search handbook content from the same session where you are coding or planning.
How do I add Handbook MCP to my agent?
Install @ah-oh/handbook-mcp-server from npm, set HANDBOOK_API_TOKEN (and HANDBOOK_API_URL if not default), register the stdio server in your MCP config, then invoke CRUD and search tools from the client.