# BPMN Kit

Lets an agent build and check Camunda 8 process diagrams, forms and DMN decisions, then push them to a cluster. Useful when nobody wants to drag boxes by hand.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 12
- Author: bpmnkit
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/bpmnkit/bpmnkit/tree/HEAD/apps/cli
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/bpmn-kit

## What it does

The server exposes BPMN Kit tooling to your agent. It writes and validates `.bpmn`, `.form` and `.dmn` files, runs them through a simulator, and ships them to a Camunda 8 cluster. Everything goes through `npx -y @bpmnkit/cli`, so there is no separate install step beyond registering the server.

Behind it sits the `casen` command-line tool: profiles, deployment, incident and job listings, connector templates generated from OpenAPI specs. The agent just calls the operation it needs.

Talking to a real cluster takes `ZEEBE_ADDRESS`, `ZEEBE_CLIENT_ID` and `ZEEBE_CLIENT_SECRET`. Register the server without them and it works on local files only — no deployment, so do not expect one.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ZEEBE_ADDRESS`, `ZEEBE_CLIENT_ID`, `ZEEBE_CLIENT_SECRET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ZEEBE_ADDRESS=<ZEEBE_ADDRESS> --env ZEEBE_CLIENT_ID=<ZEEBE_CLIENT_ID> --env ZEEBE_CLIENT_SECRET=<ZEEBE_CLIENT_SECRET> --transport stdio cli -- npx -y @bpmnkit/cli
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add cli --env ZEEBE_ADDRESS=<ZEEBE_ADDRESS> --env ZEEBE_CLIENT_ID=<ZEEBE_CLIENT_ID> --env ZEEBE_CLIENT_SECRET=<ZEEBE_CLIENT_SECRET> -- npx -y @bpmnkit/cli
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "cli": {
            "command": "npx",
            "args": [
                "-y",
                "@bpmnkit/cli"
            ],
            "env": {
                "ZEEBE_ADDRESS": "<ZEEBE_ADDRESS>",
                "ZEEBE_CLIENT_ID": "<ZEEBE_CLIENT_ID>",
                "ZEEBE_CLIENT_SECRET": "<ZEEBE_CLIENT_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "cli": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@bpmnkit/cli"
            ],
            "env": {
                "ZEEBE_ADDRESS": "<ZEEBE_ADDRESS>",
                "ZEEBE_CLIENT_ID": "<ZEEBE_CLIENT_ID>",
                "ZEEBE_CLIENT_SECRET": "<ZEEBE_CLIENT_SECRET>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ZEEBE_ADDRESS=<ZEEBE_ADDRESS> -e ZEEBE_CLIENT_ID=<ZEEBE_CLIENT_ID> -e ZEEBE_CLIENT_SECRET=<ZEEBE_CLIENT_SECRET> cli npx -y @bpmnkit/cli
```
Replace <…> with your own values

## When to use it
- turn a written description into a BPMN process diagram
- validate forms and DMN decisions before shipping
- run a process scenario in the simulator with no cluster
- push prepared files to Camunda 8 in one call
- generate connector templates from an OpenAPI spec

## Example prompts
- Build an order process with a payment check and save it as `order-process.bpmn`
- Validate the forms in this folder and list the errors
- Deploy `order-process.bpmn` to the active profile

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md