camunda-mcp¶

Camunda (7 & 8) process automation API + MCP Server + A2A Agent for the scion-sdk ecosystem — a typed, deterministic tool surface over the Camunda 7 Engine REST API and the Camunda 8 Zeebe / Operate / Tasklist REST APIs.

Official documentation

This site is the canonical reference for camunda-mcp, maintained alongside every release.

Overview¶

camunda-mcp wraps the Camunda process automation APIs with thin, deterministic MCP tools, supporting both platforms from a single server. It provides:

Api — a facade (camunda_mcp.api_client) holding both the Camunda 7 Engine REST client (Camunda7Api) and the Camunda 8 Zeebe / Operate / Tasklist client (Camunda8Api), each constructed lazily so a server configured for one platform never needs the other's URLs or credentials.
MCP tools — one tool per API operation, camunda7_<operation> (39) and camunda8_<operation> (24), plus camunda_deploy and camunda_ingest_processes. capability through a Pydantic-AI graph agent for agent-to-agent orchestration.

Explore the documentation¶

:material-rocket-start: Installation — pip, source, extras, and the prebuilt Docker image.
Deployment — run the MCP and agent servers, Docker Compose, Caddy + Technitium.
Usage — the MCP tools, the Api client, and the CLI.
Backing Platform — deploy Camunda with Docker.
Overview — the Camunda 7 / Camunda 8 surface.
Concepts — the CONCEPT:CAMUNDA-* registry.

Quick start¶

pip install "camunda-mcp[mcp]"
camunda-mcp                       # stdio MCP server (default transport)

Connect it to a Camunda platform:

export CAMUNDA_PLATFORM=7
export CAMUNDA7_URL=http://your-camunda:8080/engine-rest
camunda-mcp --transport streamable-http --host 0.0.0.0 --port 8000

See Installation and Deployment for the full matrix (PyPI extras, Docker image, all transports, the agent server, reverse proxy, DNS).

Spec delivery¶

Spec delivery dashboard. No owned specs are recorded yet. Missing requirement and code mappings remain unknown.