🏭 Camunda Engine MCP Server

![Production Ready](PRODUCTION_READINESS_REPORT.md) ![Docker](https://hub.docker.com) ![MCP](https://modelcontextprotocol.io) ![Camunda](https://camunda.com)

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.

🚀 Quick Start

1. Start the Server

git clone <repo-url>
cd camunda-engine-mcp
docker-compose up -d

2. Configure Claude Desktop

Add 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"
      ]
    }
  }
}

3. Restart Claude Desktop

Completely close and restart Claude Desktop to load the MCP server.

4. Test Connection

Try these commands in Claude Desktop: `` Show me all available processes in Camunda ` ` Get the list of current tasks from Camunda ` ` Deploy BPMN from file /workspace/bpmn/simple-process.bpmn ``

🎯 Features

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

📁 File Deployment

For large BPMN/form files, place them in directories: ``bash ./bpmn-files/your-process.bpmn # → /workspace/bpmn/your-process.bpmn ./forms/your-form.form # → /workspace/forms/your-form.form ``

Then use file paths instead of content: `` Deploy BPMN from file /workspace/bpmn/your-process.bpmn ``

📚 Documentation

Setup Guide - Detailed configuration and all 21 tools
Troubleshooting - Common issues and solutions
Testing Guide - Comprehensive testing framework
Production Report - Production readiness details

🔧 Environment Variables

CAMUNDA_BASE_URL=https://your-camunda-instance.com/engine-rest
CAMUNDA_USERNAME=your-username
CAMUNDA_PASSWORD=your-password

🧪 Health Check

docker exec camunda-mcp-server npm run health-check

📞 Support

Issues: 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! 🚀

Camunda Engine MCP Server