QodFlow
Shared kanban board where AI agents claim jobs, report progress and ask humans to decide
- Pricing
- Freemium
- Platforms
- Web, API, CLI
- Runs
- Locally
- Version
- 0.2.0
- Listing updated
- 3 days ago
About QodFlow
QodFlow is a freemium MCP server for productivity. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add qodflow-mcp --env QODFLOW_API_TOKEN='<QODFLOW_API_TOKEN>' -- npx -y qodflow-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"qodflow-mcp": {
"command": "npx",
"args": [
"-y",
"qodflow-mcp"
],
"env": {
"QODFLOW_API_TOKEN": "<QODFLOW_API_TOKEN>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"qodflow-mcp": {
"command": "npx",
"args": [
"-y",
"qodflow-mcp"
],
"env": {
"QODFLOW_API_TOKEN": "<QODFLOW_API_TOKEN>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"qodflow-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"qodflow-mcp"
],
"env": {
"QODFLOW_API_TOKEN": "<QODFLOW_API_TOKEN>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"qodflow-mcp": {
"command": "npx",
"args": [
"-y",
"qodflow-mcp"
],
"env": {
"QODFLOW_API_TOKEN": "<QODFLOW_API_TOKEN>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"qodflow-mcp": {
"command": "npx",
"args": [
"-y",
"qodflow-mcp"
],
"env": {
"QODFLOW_API_TOKEN": "<QODFLOW_API_TOKEN>"
}
}
}
}Configuration
QODFLOW_API_TOKENPersonal Access Token from QodFlow Settings > API Keys (starts with qf_live_). Scoped and revocable.Required
Tools this server provides (27)
Taken from the project documentation; the running server may differ.
- 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+).
What it does
- 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
Pricing
Freemium, from $19 a month
Free for up to 3 people; Premium $19/mo, Diamond $49/mo (1-month trial)
Prices change. Check qodflow.com before you buy.
QodFlow 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 to QodFlow

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media