# QodFlow

> QodFlow is a freemium MCP server for productivity. Shared kanban board where AI agents claim jobs, report progress and ask humans to decide. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $19 a month
- **Platforms:** Web, API, CLI
- **Website:** https://www.qodflow.com/docs/mcp
- **Repository:** https://github.com/qodflow/qodflow-mcp
- **MCP Registry name:** com.qodflow/qodflow-mcp
- **Categories:** productivity
- **Listing updated:** 2026-11-14

## About

QodFlow is a job board with per-stage time limits, and this server lets an agent work the same board as your team. An agent starts a session with `get_briefing`, which lists decisions waiting on humans, expired decisions it must not act on, jobs it holds and new human notes. It can then claim a job with a lease so other agents skip it, post progress notes, attach evidence, and move or assign the card.

The human-in-the-loop part is `request_human_decision`: the agent offers two to six options and waits. If a person answers in chat instead, `resolve_decision` records it, and the board marks it as reported by the agent. Access is through a scoped, revocable personal token (`qf_live_`), so each agent can be limited to read, write or claim scopes.

Some tools depend on the plan: tags, evidence and stage WIP limits need Premium, and the free plan allows 10 AI decisions a month.

## Features

- **Session briefing:** `get_briefing` summarises pending decisions, expired approvals, held jobs and new notes.
- **Job leases:** Agents claim and release jobs so work is not duplicated.
- **Human decisions:** Agents ask the team to pick from 2-6 options and wait for the answer.
- **Audit trail:** Progress notes, evidence and moves land on each job's timeline.
- **Scoped tokens:** Tokens carry scopes such as jobs:read, jobs:write and mcp:claim.
- **Checklists and tags:** Manage checklist items and tags on a job (tags need Premium).

## Good for

- Let a coding agent pick up queued jobs without clashing with others
- Require a human approval before an agent proceeds
- Track agent progress on a shared work-order board
- Create jobs from saved templates
- Review how long jobs sit in each stage

## Install

### Claude Code (Terminal)

```sh
claude mcp add qodflow-mcp --env QODFLOW_API_TOKEN='<QODFLOW_API_TOKEN>' -- npx -y qodflow-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "qodflow-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qodflow-mcp"
      ],
      "env": {
        "QODFLOW_API_TOKEN": "<QODFLOW_API_TOKEN>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "qodflow-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qodflow-mcp"
      ],
      "env": {
        "QODFLOW_API_TOKEN": "<QODFLOW_API_TOKEN>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "qodflow-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "qodflow-mcp"
      ],
      "env": {
        "QODFLOW_API_TOKEN": "<QODFLOW_API_TOKEN>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "qodflow-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qodflow-mcp"
      ],
      "env": {
        "QODFLOW_API_TOKEN": "<QODFLOW_API_TOKEN>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "qodflow-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "qodflow-mcp"
      ],
      "env": {
        "QODFLOW_API_TOKEN": "<QODFLOW_API_TOKEN>"
      }
    }
  }
}
```

## Tools

- `get_briefing`: Session start summary of pending decisions, expired decisions, held jobs and new notes.
- `list_jobs`: Lists active jobs with filters for stage, assignee, status, flag, tag, due date and text.
- `list_stages`: Lists pipeline stages with order, colour, SLA and WIP limit.
- `create_job`: Creates a job in the first stage or a given stage, optionally from a template.
- `update_job`: Updates title, description, priority, PO number or due date.
- `move_job`: Moves a job to another stage with an optional reason.
- `assign_job`: Assigns or unassigns a job to a team member.
- `claim_job`: Claims a job with a lease so other agents skip it.
- `release_job`: Releases a claimed job.
- `report_progress`: Posts a progress note to the job timeline.
- `attach_evidence`: Attaches a note and link as proof of work (Premium+).
- `request_human_decision`: Asks the team to pick from 2-6 options while the agent waits.
- `resolve_decision`: Records a decision a human gave in chat.
- `ack_decision`: Marks a resolved or expired decision as read.
- `list_decisions`: Lists open and recently resolved decisions on a job.
- `get_timeline`: Reads a job's recent timeline.
- `list_checklist`: Lists a job's checklist items.
- `add_checklist_item`: Adds a checklist item to a job.
- `set_checklist_item`: Ticks or edits a checklist item.
- `list_tags`: Lists workspace tags.
- `create_tag`: Creates a tag.
- `add_tag`: Attaches a tag to a job (Premium+).
- `remove_tag`: Detaches a tag from a job (Premium+).
- `list_members`: Lists team members and roles.
- `list_templates`: Lists job templates.
- `update_stage`: Renames a stage or changes SLA, colour or WIP limit.
- `list_evidence`: Lists evidence attached to a job (Premium+).

## FAQ

### How do I connect it?

Create a token under Settings > API Keys, then run `npx qodflow-mcp` with `QODFLOW_API_TOKEN` set.

### Can an agent act without approval?

Only for what its token scopes allow; decisions must be requested from humans and expired ones are not to be acted on.

### What does the free plan include?

Up to 3 people, 10 active jobs and 10 AI tool decisions a month.

### Which plans are paid?

Premium is $19 a month and Diamond $49 a month, each with a one-month trial.

### Is QodFlow free?

QodFlow has a free plan, with paid plans for more usage or features. Paid plans start at $19 a month.

### How do I add QodFlow to Claude Code?

Run this command in your terminal: claude mcp add qodflow-mcp --env QODFLOW_API_TOKEN='<QODFLOW_API_TOKEN>' -- npx -y qodflow-mcp

### What are the best alternatives to QodFlow?

The closest alternatives to QodFlow are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

## Alternatives

- [Ha MCP](https://ai-powered.com/mcp/ha-mcp): Ha MCP is an open-source MCP server for productivity.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.
- [note1](https://ai-powered.com/mcp/note1): note1 is an MCP server for productivity.
- [CalderFlow](https://ai-powered.com/mcp/calderflow): CalderFlow is a free MCP server for design and media.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [ConvertAudioToText](https://ai-powered.com/mcp/convertaudiototext): ConvertAudioToText is a freemium MCP server for design and media.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Hostlet](https://ai-powered.com/mcp/hostlet): Hostlet is a free MCP server for productivity.

---
Source: https://ai-powered.com/mcp/qodflow
