Provides tools for managing BPMN processes, user tasks, and forms in Camunda Platform, allowing AI agents to deploy, start, monitor processes, and handle tasks.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Camunda Engine MCP Server List all running process instances"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Model Context Protocol (MCP) server that enables AI assistants to interact with Camunda Platform workflow engine. Provides 21 specialized tools for complete workflow automation and process management.
✅ PRODUCTION READY - Fully tested, containerized, and ready for deployment.
git clone <repo-url>
cd camunda-engine-mcp
docker-compose up -dAdd to your Claude Desktop MCP settings:
{
"mcpServers": {
"camunda": {
"command": "docker",
"args": [
"exec", "-i",
"-e", "CAMUNDA_BASE_URL=https://your-camunda-instance.com/engine-rest",
"-e", "CAMUNDA_USERNAME=your-username",
"-e", "CAMUNDA_PASSWORD=your-password",
"camunda-mcp-server",
"node", "build/index.js"
]
}
}
}Completely close and restart Claude Desktop to load the MCP server.
Try these commands in Claude Desktop:
Show me all available processes in CamundaGet the list of current tasks from CamundaDeploy BPMN from file /workspace/bpmn/simple-process.bpmnRelated MCP server: n8n-manager-mcp
21 MCP Tools for complete Camunda workflow management
Process Management - Deploy, start, monitor BPMN processes
Task Management - Handle user tasks and forms
Large File Support - Deploy big BPMN files via file paths
Production Ready - Docker, monitoring, health checks
Real-time Integration - Direct connection to live Camunda instances
For large BPMN/form files, place them in directories:
./bpmn-files/your-process.bpmn # → /workspace/bpmn/your-process.bpmn
./forms/your-form.form # → /workspace/forms/your-form.formThen use file paths instead of content:
Deploy BPMN from file /workspace/bpmn/your-process.bpmnSetup Guide - Detailed configuration and all 21 tools
Troubleshooting - Common issues and solutions
Testing Guide - Comprehensive testing framework
Production Report - Production readiness details
CAMUNDA_BASE_URL=https://your-camunda-instance.com/engine-rest
CAMUNDA_USERNAME=your-username
CAMUNDA_PASSWORD=your-passworddocker exec camunda-mcp-server npm run health-checkIssues: Check Troubleshooting Guide
Setup: See Setup Guide
Testing: Run npm run health-check
Ready to automate your workflows with AI? Start with the Quick Start above! 🚀
Activate a suspended process instance
Inputs: processInstanceId (required).
Complete a task
Inputs: taskId (required), variables.
Delete a deployment by id
Inputs: deploymentId (required), cascade, skipCustomListeners, skipIoMappings.
Delete a process instance
Inputs: processInstanceId (required), reason, skipCustomListeners, skipIoMappings, +1 more.
Deploy a BPMN process definition from content or file
Inputs: deploymentName (required), bpmnContent (required), fileName, enableDuplicateFiltering, +1 more.
Deploy a Camunda Form from content or file
Inputs: deploymentName (required), formContent (required), fileName.
Get activity instances for a process instance
Inputs: processInstanceId (required).
Get resources of a deployment
Inputs: deploymentId (required).
Get a list of deployments
Inputs: id, name, nameLike, source, +2 more.
Get incidents (errors) in processes
Inputs: processInstanceId, incidentType, maxResults.
Get a list of process definitions
Inputs: latestVersionOnly, firstResult, maxResults.
Get a list of process instances
Inputs: processDefinitionId, processDefinitionKey, businessKey, firstResult, +1 more.
Get variables of a process instance
Inputs: processInstanceId (required).
Get the start form for a process definition
Inputs: processDefinitionId, processDefinitionKey.
Get the form for a task
Inputs: taskId (required).
Get a list of tasks
Inputs: processInstanceId, taskDefinitionKey, assignee, firstResult, +1 more.
Set/update variables of a process instance
Inputs: processInstanceId (required), variables (required).
Start a new process instance
Inputs: processDefinitionId (required), processDefinitionKey, variables, businessKey.
Submit a start form and start process instance
Inputs: processDefinitionId, processDefinitionKey, variables, businessKey.
Submit a task form
Inputs: taskId (required), variables (required).
Suspend a process instance
Inputs: processInstanceId (required).
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 21 tools
Each tool targets a distinct operation (e.g., deployment, process instance, task, variable, form) with clear boundaries. Overlapping purposes like startProcessInstance and submitStartForm are differentiated by direct vs. form-based start.
All tools follow a consistent verb_noun pattern in camelCase (e.g., deployBpmn, getTasks, completeTask). No mixing of styles or irregular abbreviations.
21 tools appropriately cover a BPM engine's core operations without being excessive. The count is well-scoped for the domain's complexity.
The tool surface provides CRUD operations for deployments, process instances, tasks, and variables, plus form handling and incident querying. No obvious gaps for typical lifecycle management.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Zero-setup MCP gateway securely connecting AI to your tools with authentication and workflows
Build and run AI workflows, agents, data tables and 1000+ API integrations from any MCP client.