MCP server - Celery Root

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.