Caelo CMS
Edit a self-hosted Caelo CMS site from an agent, with writes held in a draft
- Platforms
- CLI, self-hosted
- Runs
- Locally
- Version
- 0.12.9
- Listing updated
- today
Similar MCP servers
About Caelo CMS
Caelo CMS is an MCP server for developer tools. It runs locally on your machine and is started by your AI client.
The server is a thin local shim over a Caelo install's admin API and never touches the database. A token minted by an Owner at /settings/mcp decides which of two surfaces you get. A chat-scope token exposes one tool, caelo_chat, which hands an outcome to Caelo's built-in assistant and bills the install's own AI key. An admin-scope token, called Power-MCP, exposes the assistant's full tool catalogue so your own agent reasons and Caelo makes no AI calls unless you allow it.
Neither surface can publish. Everything lands in the site's draft and going live is always a person's click in the Caelo admin. Tokens expire after 90 days, can carry an AI spend cap, and share one audit trail. Minting and revoking tokens through chat is approval-gated.
It runs over stdio with bunx, and Claude Code is the tested client; Claude Desktop, Cursor and Codex CLI should work but are untested, and browser connectors such as ChatGPT and claude.ai are not supported because there is no remote endpoint. Installs on Google Cloud behind Identity-Aware Proxy add a service account variable and a gcloud login. An export command can also write a CLAUDE.md and skills tree from the install's live context.
Install
Run in a terminal
claude mcp add caelo --env CAELO_ADMIN_URL='<CAELO_ADMIN_URL>' --env CAELO_MCP_TOKEN='<CAELO_MCP_TOKEN>' -- npx -y @caelo-cms/mcp-serverAdd to claude_desktop_config.json
{
"mcpServers": {
"caelo": {
"command": "npx",
"args": [
"-y",
"@caelo-cms/mcp-server"
],
"env": {
"CAELO_ADMIN_URL": "<CAELO_ADMIN_URL>",
"CAELO_MCP_TOKEN": "<CAELO_MCP_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"caelo": {
"command": "npx",
"args": [
"-y",
"@caelo-cms/mcp-server"
],
"env": {
"CAELO_ADMIN_URL": "<CAELO_ADMIN_URL>",
"CAELO_MCP_TOKEN": "<CAELO_MCP_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"caelo": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@caelo-cms/mcp-server"
],
"env": {
"CAELO_ADMIN_URL": "<CAELO_ADMIN_URL>",
"CAELO_MCP_TOKEN": "<CAELO_MCP_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"caelo": {
"command": "npx",
"args": [
"-y",
"@caelo-cms/mcp-server"
],
"env": {
"CAELO_ADMIN_URL": "<CAELO_ADMIN_URL>",
"CAELO_MCP_TOKEN": "<CAELO_MCP_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"caelo": {
"command": "npx",
"args": [
"-y",
"@caelo-cms/mcp-server"
],
"env": {
"CAELO_ADMIN_URL": "<CAELO_ADMIN_URL>",
"CAELO_MCP_TOKEN": "<CAELO_MCP_TOKEN>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
CAELO_ADMIN_URLYour Caelo admin's https:// address, e.g. https://admin.example.comRequiredCAELO_MCP_TOKENMCP token minted at /settings/mcp on your installRequiredCAELO_IAP_SERVICE_ACCOUNTOnly for Google Cloud (IAP) installs; /settings/mcp shows the value
Tools this server provides (1)
Taken from the project documentation; the running server may differ.
- caelo_chat
- Sends a message to Caelo's built-in assistant.
What it does
- Two token scopes
- Chat scope uses Caelo's assistant; admin scope exposes the full tool catalogue.
- Draft-only writes
- Changes land in a draft and a person publishes.
- Spend caps
- Optional AI cost cap per token.
- Expiring tokens
- Tokens last 90 days and can be rotated or revoked.
- IAP support
- Works with Google Cloud installs behind Identity-Aware Proxy.
- Context export
- Generates a CLAUDE.md and skills from the install.
Good for
- Let Claude Code rewrite page copy in a draft
- Ask Caelo's assistant to build a page and review it before publishing
- Drive Caelo's full tools from your own agent
- Keep an audit trail of agent edits to a CMS
Pricing
Pricing unknown
Connector for a self-hosted Caelo CMS install; prices not published
Prices change. Check caelo-cms.com before you buy.
Caelo CMS FAQ
Can the agent publish pages?
No. Writes stay in the draft and publishing is a person's click.
Which clients work?
Claude Code is tested; other stdio-capable clients should work.
Does it work with ChatGPT or claude.ai?
Not yet; there is no remote MCP endpoint.
What do I need?
A Caelo install, its admin URL and an MCP token minted in /settings/mcp.
How do I add Caelo CMS to Claude Code?
Run this command in your terminal: claude mcp add caelo --env CAELO_ADMIN_URL='<CAELO_ADMIN_URL>' --env CAELO_MCP_TOKEN='<CAELO_MCP_TOKEN>' -- npx -y @caelo-cms/mcp-server
What are the best alternatives to Caelo CMS?
The closest alternatives to Caelo CMS are REA, Context7, Chrome DevTools MCP, Codebase Memory and GitHub.
Where this comes from
- Description: written from the project's README and the project's website.
- Install steps: from the official MCP Registry entry.


