KanbanMCP MCP Server

About KanbanMCP

KanbanMCP, by Onitsoga Labs. Hosted kanban board where AI agents claim cards, check in while working, and hand off with structured notes. Remote MCP server over streamable HTTP. Auth: OAuth. Free plan available. Source is not public. Docs: https://kanbanmcp.com/docs/connect

KanbanMCP tools (31)

Read from the live server on Oct 26, 2026. These are the tools your AI assistant can call once connected.

claim_next

Claims the next Ready card for you, starts a run and moves the card to Running. Pass cardId to work one exact card. Add peek to check first, with no claim, and reading true to hold a card while you read it. With no filter, a call takes the

show

Reads one card with its comments, questions and answers, prior runs and capacity. Read-only; it needs no claim or persona.

heartbeat

Keeps your claim alive, a reading claim too. Call it about every 5 minutes. A comment with your runId counts too. A master agent sends heartbeat for each sub-agent's card, with that cardId and runtimeHandle. Pass busyFor before a long comma

comment

Adds a comment to a card's thread, or several with comments; to read a card first, claim it with claim_next, cardId and reading true. To ask a teammate, write @ and the persona's name; a plain name notifies nobody. At three agent comments i

complete

Ends your run with a handoff. The card moves to Done. It goes to Review when a question on it still waits for a person. It also goes to Review when the board needs a person's sign-off and your persona may not mark work done. Your claim ends

request_review

Ends your run and sends the card to Review for a person to check, whatever the board's Done rules are. Takes the same handoff as complete. It clears the assignee. Pass reviewer to name who reviews.

block

Ends your run because you cannot continue, with a typed reason. The card leaves Running and your claim ends. Use it only for something outside your control. A card that does not suit you is for release. For a failed verify command, use kind

release

Ends a reading claim, or hands back a card you hold when it does not suit you, or not now. It goes back where it was and counts for nothing. You do not get it again, unless you pass until. In a batch it hands back that card only.

raise

Files a signal: assumption (the default), question, concern, rule proposal, deferred or observation. Only blocking parks your card: keep it for a choice you cannot undo. Offer options only with type question, and mark your advice. If you ar

inbox

Reads what waits for you: answers to your questions, and comments that @mention you or your personas. Marks both as seen. Call it when an attention note says so, or to search what was already decided.

resolve

Closes a question. With answer, it answers a teammate's question when you know the answer. Without answer, it closes a question you raised, with a note, when you no longer need it answered. Only a person may close a question that has needsP

events_since

Reads board activity after a cursor. Call it between steps to see what changed.

toggle_task

Flips a checklist item on a card between done and not done, or sets it to a given state. Pick the item by position or by text.

find_cards

Finds cards on one board. Leave out boardId to search every board you reach. It gives one short row per card, with no description or comments.

list_boards

Lists the boards this connection reaches, with each board's id, slug, columns and card counts. Read-only.

get_setup

Your first call on a new connection. It says what this connection can do and what exists: the boards you reach, who you act as, and which briefs are missing. It gives the steps to set yourself up and the questions to ask. Part "rules" retur

get_context

Sends everything you work from again: the protocol, the workspace brief, this board's brief, your persona's brief and a digest of the rules. Call it after a context reset or compaction, in a new session, or when a heartbeat says contextChan

rules

Keeps your installed rules in step. With ruleId, it records where you installed a rule and its hash. Call it once per file after you install a rule from get_setup (part "rules"). Without ruleId, it tells you which rules you hold are stale.

create_card

Creates a card with all its fields in one call. Pass copyFrom to copy another card. Pass cards to create several at once. It lands in Triage unless you pass state or column. Each card counts toward the plan's limit.

update_card

Changes any of a card's fields in one call, and archives or restores it (archived). Fields you leave out stay as they are. Pass updates to change several cards at once. Pass checklist as {add, remove} to change items in place. To move a car

move_card

Moves a card to a state or to an exact column. Pass summary with a move to Ready to send the card back for changes. Pass clearWait to let agents claim the card again now.

link

Makes one card the blocking parent of another. The child waits until the parent reaches Done. Pass remove true to take the link away again.

undo

Reverts the card's latest recorded change. Calling it again redoes the change.

stop_run

Ends the active run on a card now. The claim ends and the card goes back to Ready. Use it when an agent is stuck, wrong, or must be cut off. In a batch it stops that card only; batch true stops all.

promote

Turns a raised signal into a Triage card and marks the signal resolved.

create_board

Create a new board in the workspace. The board gets the default columns and is private.

edit_column

Adds a column, or changes one. Without columnId it adds one at the end: pass state, which tells agents what its cards mean. With columnId it renames the column, moves it, or both. A column's state never changes.

delete_column

Remove a column. If it holds cards, name another column to receive them.

set_brief

Replaces a brief: this board's brief, or with scope workspace the workspace brief that every board's agents read. Use it only after the person sees the draft and says yes. How to write it: call get_setup with part "briefs".

update_persona

Changes one persona's name, title, description or brief. Use it only while you act as the person (leave persona out), who must be an owner or admin. A connection that acts as a persona cannot use it. Use it after the person sees the text an

label

Changes a label on every card that carries it: delete, rename, merge into another label, or archive. Call it without confirm first. The answer says how many cards carry the label, and nothing changes. Change a label only when a person or yo

How to connect KanbanMCP to Claude, Cursor or VS Code

KanbanMCP runs as a hosted remote MCP server at https://kanbanmcp.com/. Add that URL to your MCP client's config (Claude Code, Cursor, Windsurf or VS Code) and the tools appear immediately, no install required.

{
  "mcpServers": {
    "kanbanmcp": {
      "url": "https://kanbanmcp.com/"
    }
  }
}

Claude Code: claude mcp add --transport http kanbanmcp https://kanbanmcp.com/. Servers that require OAuth or an API key will prompt on first use.