Kirby MCP
Kirby MCP gives an agent a Kirby CMS project: structure, live content, debugging and a bundled Kirby knowledge base
- 69 ★ on the repository
- Last commit
Broad access
Why this level
- Tools change and delete site pages and files and run Kirby CLI commands and `kirby_eval`
- Remote mode exposes a live site to the agent over HTTPS and OAuth
Install
- Works in
Manual install
claude mcp add kirby -- "$PWD/vendor/bin/kirby-mcp" "--project=$PWD"Before this, in the project root: `composer require --dev bnomei/kirby-mcp:"^6.0"` and `vendor/bin/kirby-mcp install`.
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- Tools change and delete site pages and files and run Kirby CLI commands and `kirby_eval`
- Remote mode exposes a live site to the agent over HTTPS and OAuth
This is third-party code. Review the repository files before installing.
What it does
Kirby MCP installs into a Kirby 6 project on PHP 8.3 or newer through Composer and connects the agent to site structure, live content and runtime debugging. Tools read and change pages, files, users and the site, look up templates, controllers, models, routes, blueprints and plugins, render pages and generate IDE helpers. There is a call for Kirby CLI commands, a log tail reader and a Composer audit check. Your own project commands can be exposed as MCP tools with validated inputs and an allowlist. Besides site access it carries a knowledge base: a glossary of concepts, task recipes such as forms and routing, and guides to content updates and Panel development. The agent searches it with `kirby_search` or reads `kirby://kb` addresses with no network requests.
Who it is for. Kirby CMS developers who edit a project templates, blueprints and content with Claude Code or Codex.
Good fit when
- You need to find a page template, controller or blueprint and see how they connect
- Page content is updated in batches and field formats must be checked before writing
- The agent must render a page and show an error from the log
- A project and plugin need IDE helpers and a Composer audit
- A hosted site connects remotely over HTTPS and OAuth with a restricted account
Not a fit when
- The project does not use Kirby or Composer: the server targets Kirby 6 on PHP 8.3
- You need only a reference with no project: a knowledge base access mode exists for that
- A production site must not be opened to an agent with write access
Example request
Find the Blog page template and blueprint, render the page and show Kirby log errorsMCP
- Transport
- stdio, http
- Authentication
- not required
Limitations
It targets Composer projects on Kirby 6 and PHP 8.3 or newer. The verified baseline is Kirby CMS 6.0.0-beta.3, and a stable MCP version does not make the CMS beta production ready. Tools include `kirby_eval`, `kirby_run_cli_command` and deletion of pages and files, so connect the server to a copy of the site first. After upgrading to version 6.4.0 existing HTTP sessions must reconnect. The installer creates a plugin adapter and a `.kirby-mcp/mcp.json` file in the project.
How to disable. Remove the package with `composer remove bnomei/kirby-mcp --dev` and drop the entry from the client, for example `claude mcp remove kirby`. The adapter files and `.kirby-mcp/` are covered in the README Maintenance section.
FAQ
How do I connect Kirby MCP to Claude Code?
From the project root run `claude mcp add kirby -- "$PWD/vendor/bin/kirby-mcp" "--project=$PWD"`. For Codex use `codex mcp add kirby -- "$PWD/vendor/bin/kirby-mcp"`.
Does the server need to stay running?
No, the MCP client starts the process itself and no separate terminal is needed.
What is the bundled knowledge base?
A glossary of Kirby concepts, task recipes, content update guides and Panel development guides. Search runs locally through `kirby_search`.
Can I connect a hosted site?
Yes, through the remote mode with HTTPS, OAuth and a restricted Kirby account. The remote install tutorial describes the steps.
Which versions does it need?
Kirby 6, PHP 8.3 or newer and Composer. MCP version 6.4.0 integrates the MCP PHP SDK v0.10.0.
Discussion
No questions or reviews yet.
Related
MCP serversSitecore Community MCP: operate Sitecore from an agent
Sitecore Community MCP
A community MCP server with 121 tools for Sitecore XM, XP and SitecoreAI: items, templates, media, presentation and PowerShell
FireCMS Cloud MCP server: an agent reads Firestore data, infers collection schemas and manages the project's users.
An MCP server and plugin for agents that generate web APIs from OpenAPI, AsyncAPI, GraphQL, gRPC and SQL specs on a Rust core.
Sanity's official agent kit: a remote MCP with project access, skills on content modeling, SEO and migrations, and plugins
Bitrix24 MCP Server (lstkhN)
Bitrix24 MCP Server
A module for on-premise Bitrix24: an agent safely reads CRM, the MySQL schema, code and business processes over SSH stdio or HTTP with a Bearer token
PubNub MCP: PubNub docs and apps in an agent
PubNub MCP Server
PubNub's official MCP server: SDK docs in 20 languages and management of apps, keysets, channels and analytics from an agent
README in short
The README presents the server as a bridge between the agent and a Kirby project with a bundled knowledge base. A Composer quick start follows, then client setup for Claude Code and Codex, sample prompts, the tool and resource lists, remote site support and a maintenance section.