# QodFlow

MCP server that connects AI agents to QodFlow, a kanban board with SLA tracking shared by people and AI. Agents claim jobs, report progress, move them between stages, and ask for human approval when needed.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: qodflow
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/qodflow/qodflow-mcp
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/qodflow

## What it does

QodFlow exposes 27 tools over MCP: create and list jobs, move them across pipeline stages, manage assignments and checklists, add timeline notes, request human decisions with voting or options, and acknowledge approvals. The agent retrieves a briefing on startup showing pending decisions, unread approvals, and expired requests that block progress.

Setup requires a Personal Access Token generated in QodFlow (Settings → API Keys → New token). Pick the scopes you need; read-only work starts with `jobs:read` and `stages:read`. Pass the token via the `QODFLOW_API_TOKEN` environment variable. The server connects to `https://www.qodflow.com` via MCP, keeps nothing on disk, and enforces a 120 requests/minute rate limit per token. Destructive operations (team deletion, mass moves) are never exposed through MCP; they live behind the UI's confirm-literal guard only.

One nuance: when the agent requests human approval and you give it in chat, use the tool to report that approval back to the board. Board-level approvals are recorded separately and show as verified; chat approvals show as reported by the agent.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `QODFLOW_API_TOKEN` — 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 qodflow-mcp -e QODFLOW_API_TOKEN=<QODFLOW_API_TOKEN> -- npx -y qodflow-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add qodflow --env QODFLOW_API_TOKEN=<QODFLOW_API_TOKEN> -- npx -y qodflow-mcp
```
Replace <…> with your own values

### Cursor

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

### GitHub Copilot

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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e QODFLOW_API_TOKEN=<QODFLOW_API_TOKEN> qodflow npx -y qodflow-mcp
```
Replace <…> with your own values

## When to use it
- Let AI agents claim and complete jobs on a shared kanban board without UI switching
- Request human approval for a decision in chat and have the agent record it on the job
- Track job age at each stage and enforce SLA compliance across the team
- Spawn jobs from templates and fill checklists as work progresses
- Give agents visibility into the job queue, blockers, and pending decisions

## Example prompts
- Create a job from the standard template and move it to done
- Show me all active jobs tagged urgent and ask which ones I want to approve for release
- Request a decision: should we move this job to completed?

## Similar
- [ak-plan](https://affpapa.org/en/nevibecode/skills/ak-plan.md) — skill · 139 installs
- [Kanzo](https://affpapa.org/en/nevibecode/mcp/kanzo.md) — MCP server · ★ 1305 repo stars
- [claudia](https://affpapa.org/en/nevibecode/mcp/claudia.md) — MCP server · ★ 15 repo stars
- [KanbanThing](https://affpapa.org/en/nevibecode/mcp/kanbanthing.md) — MCP server · ★ 11 repo stars
- [Yokka](https://affpapa.org/en/nevibecode/mcp/yokka.md) — MCP server
- [obsidian-board](https://affpapa.org/en/nevibecode/commands/obsidian-board.md) — command · ★ 5412 repo stars

---
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
