# Caelo CMS

> Caelo CMS is an MCP server for developer tools. Edit a self-hosted Caelo CMS site from an agent, with writes held in a draft. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI, self-hosted
- **Website:** https://caelo-cms.com/docs/mcp/
- **Repository:** https://github.com/caelo-cms/caelo-cms/tree/HEAD/packages/mcp-server
- **MCP Registry name:** io.github.caelo-cms/caelo
- **Categories:** [developer tools](https://ai-powered.com/categories/developer-tools), [productivity](https://ai-powered.com/categories/productivity)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add caelo --env CAELO_ADMIN_URL='<CAELO_ADMIN_URL>' --env CAELO_MCP_TOKEN='<CAELO_MCP_TOKEN>' -- npx -y @caelo-cms/mcp-server
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "caelo": {
      "command": "npx",
      "args": [
        "-y",
        "@caelo-cms/mcp-server"
      ],
      "env": {
        "CAELO_ADMIN_URL": "<CAELO_ADMIN_URL>",
        "CAELO_MCP_TOKEN": "<CAELO_MCP_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "caelo": {
      "command": "npx",
      "args": [
        "-y",
        "@caelo-cms/mcp-server"
      ],
      "env": {
        "CAELO_ADMIN_URL": "<CAELO_ADMIN_URL>",
        "CAELO_MCP_TOKEN": "<CAELO_MCP_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "caelo": {
      "command": "npx",
      "args": [
        "-y",
        "@caelo-cms/mcp-server"
      ],
      "env": {
        "CAELO_ADMIN_URL": "<CAELO_ADMIN_URL>",
        "CAELO_MCP_TOKEN": "<CAELO_MCP_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "caelo": {
      "command": "npx",
      "args": [
        "-y",
        "@caelo-cms/mcp-server"
      ],
      "env": {
        "CAELO_ADMIN_URL": "<CAELO_ADMIN_URL>",
        "CAELO_MCP_TOKEN": "<CAELO_MCP_TOKEN>"
      }
    }
  }
}
```

## Tools

- `caelo_chat`: Sends a message to Caelo's built-in assistant.

## 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.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Context7](https://ai-powered.com/mcp/context7): Context7 is a freemium MCP server for developer tools.
- [Chrome DevTools MCP](https://ai-powered.com/mcp/chrome-devtools-mcp-2): Chrome DevTools MCP is an open-source MCP server for browser automation.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [awesome-mcp-servers](https://ai-powered.com/mcp/awesome-mcp-servers-2): awesome-mcp-servers is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.

---
Source: https://ai-powered.com/mcp/caelo-cms
