Skip to content
MCP server

QodFlow

Shared kanban board where AI agents claim jobs, report progress and ask humans to decide

Runs locallyStatus and history
Install
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-mcp

Add 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

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media