Skip to content
MCP server

Caelo CMS

Edit a self-hosted Caelo CMS site from an agent, with writes held in a draft

Runs locallyStatus and history
Install
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-server

Add 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.comRequired
  • CAELO_MCP_TOKENMCP token minted at /settings/mcp on your installRequired
  • CAELO_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.

How AIPoweredBot checks servers