BPMN Kit
Build, validate, simulate and deploy Camunda 8 BPMN, DMN and forms from an agent
- Pricing
- Open source
- Platforms
- CLI, Web, self-hosted
- Runs
- Locally
- Version
- 1.9.1
- Listing updated
- 3 days ago
About BPMN Kit
BPMN Kit is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Process models are verbose, so BPMN Kit gives agents a compact JSON form of a diagram. The docs say a typical approval workflow fits in around 500 tokens, and a builder API produces valid BPMN so the model never writes raw XML. Editing an existing file calls for a reconcile step, because converting back from the compact form would silently drop parts it cannot describe, such as collaborations, lanes and multi-instance settings.
The server comes from the @bpmnkit/cli package, whose command-line tool is casen. It can also deploy files to a Camunda 8 cluster, list and cancel process instances, resolve incidents, list jobs and generate connector element templates from OpenAPI specs. A local casen dev command opens every .bpmn, .dmn and .form file in a folder in a browser editor with simulation and lint, and reruns each file's test scenarios on change.
Agents are told to run casen agent-card bpmn|dmn|form for a roughly 1k-token guide instead of reading the README. A cluster address and client credentials are read from environment variables; without any cluster, local development still works.
Install
Run in a terminal
claude mcp add bpmnkit --env ZEEBE_CLIENT_SECRET='<ZEEBE_CLIENT_SECRET>' -- npx -y @bpmnkit/cliAdd to claude_desktop_config.json
{
"mcpServers": {
"bpmnkit": {
"command": "npx",
"args": [
"-y",
"@bpmnkit/cli"
],
"env": {
"ZEEBE_CLIENT_SECRET": "<ZEEBE_CLIENT_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"bpmnkit": {
"command": "npx",
"args": [
"-y",
"@bpmnkit/cli"
],
"env": {
"ZEEBE_CLIENT_SECRET": "<ZEEBE_CLIENT_SECRET>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"bpmnkit": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@bpmnkit/cli"
],
"env": {
"ZEEBE_CLIENT_SECRET": "<ZEEBE_CLIENT_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"bpmnkit": {
"command": "npx",
"args": [
"-y",
"@bpmnkit/cli"
],
"env": {
"ZEEBE_CLIENT_SECRET": "<ZEEBE_CLIENT_SECRET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"bpmnkit": {
"command": "npx",
"args": [
"-y",
"@bpmnkit/cli"
],
"env": {
"ZEEBE_CLIENT_SECRET": "<ZEEBE_CLIENT_SECRET>"
}
}
}
}Configuration
ZEEBE_ADDRESSCamunda 8 / Reebe REST address when no casen profile is active (default http://localhost:26500)ZEEBE_CLIENT_IDOAuth client ID for Camunda SaaSZEEBE_CLIENT_SECRETOAuth client secret for Camunda SaaS
What it does
- Compact diagram format
- Represents a process as small JSON that fits in an LLM prompt.
- Valid BPMN generation
- A builder API avoids hand-written XML.
- Local editor and simulation
- casen dev opens BPMN, DMN and form files with lint and simulation.
- Camunda 8 deployment
- Deploys processes to a cluster and manages instances, incidents and jobs.
- Connector generation
- Creates element templates from OpenAPI or Swagger specs.
- Agent cards
- Short guides for BPMN, DMN and form authoring.
Good for
- Generate a Camunda process from a plain-language description
- Edit an existing BPMN file without losing unsupported parts
- Simulate and lint a process before deploying
- Deploy models and inspect incidents from a terminal
- Create connector templates from an API spec
Pricing
Open source
Open-source npm package; prices not published
Prices change. Check bpmnkit.com before you buy.
BPMN Kit FAQ
Do I need a Camunda cluster?
Not for local development; casen dev works without one.
What credentials does it read?
ZEEBE_ADDRESS, ZEEBE_CLIENT_ID and ZEEBE_CLIENT_SECRET when no profile is active.
What formats does it handle?
BPMN processes, DMN decisions and Camunda forms.
How should an agent learn the format?
By running casen agent-card for bpmn, dmn or form.
Is BPMN Kit free?
Yes. BPMN Kit is open source, so you can use and self-host it for free.
How do I add BPMN Kit to Claude Code?
Run this command in your terminal: claude mcp add bpmnkit --env ZEEBE_CLIENT_SECRET='<ZEEBE_CLIENT_SECRET>' -- npx -y @bpmnkit/cli
What are the best alternatives to BPMN Kit?
The closest alternatives to BPMN Kit are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to BPMN Kit

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools