mcp-kanban
A task board for each of your projects, driven from your AI chat. Say "add a task to the nova site board: write thelaunch email, due Friday, 90 minutes", then ask "what's on the nova board?", "what's overdue?" or "plan my week".Tasks carry a title, notes, tags, a due date, an estimate, a priority and a column (backlog, todo, doing, review,done by default), each one gets a short stable id like NS-12, and a task can hand its exact arguments to thetime-tracker server so the time you spend on it lands against the same project name. Everything is stored as plainJSON on your own machine.
Built by theluckystrike.

A local kanban board per project -- columns, due dates, estimates, weekly review -- zero setup, all local.
60-second install
npm publish for @theluckystrike/mcp-kanban is pending. Until then, the .mcpb one-click bundle or a clone+buildis the working path -- both are verified below.
One-click (.mcpb): download kanban.mcpb from the latest release and double-click it in Claude Desktop:https://github.com/theluckystrike/mcp-servers/releases/latest
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"kanban": {
"command": "npx",
"args": ["-y", "@theluckystrike/mcp-kanban"]
}
}
}
Claude Code:
claude mcp add kanban -- npx -y @theluckystrike/mcp-kanban
Cursor (.cursor/mcp.json):
{
"mcpServers": {
"kanban": {
"command": "npx",
"args": ["-y", "@theluckystrike/mcp-kanban"]
}
}
}
The npx form above starts working the moment the package is published. Until then, use the .mcpb bundle above, orbuild from source with exactly these three commands:
git clone https://github.com/theluckystrike/mcp-servers.git && cd mcp-servers
npm install
npm run build -w packages/mcp-license -w servers/kanban
Then point your client's command at node with one arg: the absolute path to servers/kanban/dist/index.js.
To run in Pro mode set MCP_LICENSE_KEY in the same config block, or call license_activate once with your key.
Tools
| Tool | What it does |
|---|---|
task_add |
Add a task: title plus optional project, column, due date, estimate, priority, tags and notes. A new project name creates its board; a partial name that matches exactly one existing project is used as that project. |
Due dates accept YYYY-MM-DD, today, tomorrow, yesterday, +3d, a weekday (friday, the nearest one from today) and next friday (the one after that). |
|
task_list |
Table of tasks, filtered by project, column, tag, due_before or overdue. Finished tasks are hidden unless you ask for them. Prints 200 rows by default and says how many more there are; raise it with limit (max 2,000). |
task_move |
Move a task to another column on its board. |
task_update |
Change any field: title, notes, due (none clears it), estimate, priority, tags, column or project. |
task_done |
Mark a task done: it moves to the done column and is stamped with the time. |
task_delete |
Delete a task. The id is never reused. |
task_search |
Find tasks by text in the title, notes, tags or id. |
board |
Column-by-column summary of one board: tasks, estimate total, actual total, overdue count. |
task_start_timer |
Return the exact arguments to pass to the time-tracker server's timer_start for this task, and record the link on the task. |
task_log_time |
Add real minutes worked to a task, so estimate and actual can be compared. |
project_list |
Every board with open and done counts, remaining estimate and overdue count. |
overdue |
Everything past its due date, across all boards; as_of measures against another day. |
weekly_review |
Done versus planned for a week, with estimate against actual per project. This week is free; past weeks are Pro. |
columns_set |
Replace one board's columns (Pro). Tasks in a removed column move to the first column. |
license_status |
Free or Pro, and where to upgrade. |
license_activate |
Activate a Pro key (verified offline). |
Also exposed: the resource kanban://today (due today plus everything overdue) and the prompt plan_week(turns the open board into a day-by-day plan that fits the hours you actually have).
What you can say
- "Add a task to the nova site board: write the launch email, due Friday, 90 minutes, high priority."
- "Move NS-3 to doing."
- "What does the nova board look like?"
- "What's overdue?"
- "Start a timer on NS-3." -- then pass the arguments it returns to the time-tracker server.
- "I spent 40 minutes on NS-3."
- "Weekly review."
Free vs Pro
| Free | Pro | |
|---|---|---|
| Project boards | 3 | unlimited |
| Open tasks | 200 | unlimited |
| Columns | the default five (backlog, todo, doing, review, done) | custom columns per board (columns_set) |
| Weekly review | the current week | any week, full history |
| Estimate vs actual reports | current week only | every week |
| Listing output | 200 rows per call, limit up to 2,000 |
same |
| Everything else | included | included |
Pro is a one-time $19 for this server, or $39 for every server, lifetime.
Get Pro: https://mcp.zovo.one/buy/kanban
Pairs with
- mcp-time-tracker --
task_start_timerhands it the project and task name, so hours land against the same project. - mcp-calendar -- due dates on the board next to what is actually in your week.
- mcp-invoice -- turn the tracked hours behind those tasks into invoice line items.
Privacy
All data stays local, in ${XDG_DATA_HOME:-~/.local/share}/mcp-servers/kanban/. Nothing is uploaded, no account isneeded, and licence keys are verified offline.
License
MIT. Support: [email protected]