Skip to main content

​
What it does

Celery Root ships with an optional MCP server that exposes read-only tools over HTTP. It lets MCP clients inspect the Celery Root SQLite store without write access.

​
Enable MCP

Set mcp in your config and provide an auth token: 
from celery_root import CeleryRootConfig, McpConfig

config = CeleryRootConfig(
    mcp=McpConfig(
        host="127.0.0.1",
        port=9100,
        path="/mcp/",
        auth_key="your-secret-token",
    ),
)
You can also set environment variables used by the web UI settings page:
  • CELERY_ROOT_MCP_ENABLED (derived from config)
  • CELERY_ROOT_MCP_HOST
  • CELERY_ROOT_MCP_PORT
  • CELERY_ROOT_MCP_PATH
  • CELERY_ROOT_MCP_AUTH_KEY

​
Read-only database access

For SQLite, the MCP server opens the database in read-only mode. For non-SQLite databases, provide a read-only URL: 
export CELERY_ROOT_MCP_READONLY_DB_URL="postgresql://readonly:..."

​
Client snippets

The Settings page in the UI renders JSON snippets and CLI commands for Codex and Claude. Visit /settings/ after enabling MCP to copy them.