Celery Flower MCP Server

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

Local serverstdioPython

What is the Celery Flower MCP Server?

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

The short version

  • Full API coverage — — every Flower REST endpoint exposed as an MCP tool
  • Dependency injection — via dishka — clean, testable architecture
  • Pydantic Settings — — typed configuration with .env file support
  • Async — throughout — built on httpx + FastMCP
  • 65 tests — — 49 unit tests (99% coverage) + 16 integration tests against real Flower
  • Strict typing — — mypy strict mode, fully annotated

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
list_workersList all workers — optionally filter by name, refresh live stats, or get status only
shutdown_workerGracefully shut down a worker
restart_worker_poolRestart a worker's process pool
grow_worker_poolAdd N processes to a worker's pool
shrink_worker_poolRemove N processes from a worker's pool
autoscale_worker_poolConfigure autoscale min/max bounds
add_queue_consumerMake a worker start consuming from a queue
cancel_queue_consumerMake a worker stop consuming from a queue
list_tasksList tasks with filters: state, worker, name, date range, search, pagination
list_task_typesList all registered task types across workers
get_task_infoGet full details for a task by UUID
get_task_resultRetrieve a task's result (with optional timeout)
apply_taskExecute a task synchronously and wait for the result
async_apply_taskDispatch a task asynchronously, returns task UUID
send_taskSend a task by name — no registration required on worker side
abort_taskAbort a running task
revoke_taskRevoke a task; optionally terminate with a signal
set_task_timeoutSet soft and/or hard time limits for a task on a worker
set_task_rate_limitSet rate limit for a task on a worker (e.g. 100/m)
get_queue_lengthsGet the current depth of all configured queues
healthcheckCheck whether the Flower instance is reachable and healthy

How to install the Celery Flower MCP Server

{
  "mcpServers": {
    "celery-flower": {
      "command": "uvx",
      "args": [
        "celery-flower-mcp"
      ],
      "env": {
        "FLOWER_URL": "http://localhost:5555"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

VariableDescriptionRequired
FLOWER_URLDeclared in the maintainer’s client configuration.Check documentation

Example prompts to try

  • “Use Celery Flower MCP to list workers.”
  • “Use Celery Flower MCP to shutdown worker.”
  • “Use Celery Flower MCP to restart worker pool.”

Frequently asked questions

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`: Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.