mcp-vibekanban
Enables AMP to manage tasks, sessions, and monitoring in a Vibe Kanban project, including creating tasks, starting workspace sessions, sending follow-ups, and checking queue status.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-vibekanban create a task to review the PR"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server that bridges your AI coding assistant to Vibe Kanban. manage tasks, start sessions, send follow-ups, monitor execution — all without leaving Claude Code, Cursor, Amp, or whatever you're using.
VIBE_PROJECT_ID=<uuid> npx mcp-better-vibe-kanbanlocks to a single project at startup so every tool call is zero-boilerplate. no project IDs in every request.
what it does
12 MCP tools and 5 MCP resources exposed over STDIO, HTTP, or Cloudflare Workers.
tools
task management:
tool | what it does |
| project name, active task, workspace info |
| filter by status, configurable limit |
| create with |
| full task details by ID |
| title, description, status — any combination |
| irreversible delete |
session management:
tool | what it does |
| spin up a session for any executor (Claude Code, Amp, Gemini, Codex, Cursor, etc.) |
| all sessions in a workspace |
| session details by ID |
| follow-up with auto-queue fallback if session is busy. supports MCP task primitives for async tracking |
monitoring:
tool | what it does |
| check if a message is queued |
| drop the queued message |
resources
URI | description |
| all tasks in the project |
| workspace context (when |
| single task details |
| session details |
| queue status |
resources support subscriptions — polls on a configurable interval, emits updates on change via SHA-256 diffing.
Related MCP server: vibecompass-mcp
install
# run directly
VIBE_PROJECT_ID=<uuid> npx mcp-better-vibe-kanban
# legacy aliases still work
npx vibe-kanban-better-mcp
npx vkb-mcpor build from source:
git clone https://github.com/yigitkonur/mcp-better-vibe-kanban.git
cd mcp-better-vibe-kanban
pnpm install && pnpm buildrequires Node.js 18+ and a running Vibe Kanban instance (default: npx vibe-kanban on port 9119).
configuration
variable | default | description |
| — | required. UUID of the project to lock onto |
| auto-detected | repo UUID. auto-fetched if project has exactly one repo |
|
| Vibe Kanban API base URL |
| — | enables |
|
| resource subscription poll interval (ms) |
|
|
|
|
| port for HTTP transport |
client setup
Claude Desktop
{
"mcpServers": {
"mcp-better-vibe-kanban": {
"command": "npx",
"args": ["-y", "mcp-better-vibe-kanban"],
"env": {
"VIBE_PROJECT_ID": "your-project-uuid",
"VIBE_REPO_ID": "your-repo-uuid",
"VIBE_API_URL": "http://localhost:9119"
}
}
}
}Cursor
same structure, drop it in your Cursor MCP config.
HTTP transport
MCP_TRANSPORT=http MCP_PORT=3000 VIBE_PROJECT_ID=<uuid> npx mcp-better-vibe-kanbanhealth check at GET /health, MCP endpoint at POST /mcp. each HTTP session gets its own isolated server instance.
Cloudflare Workers
wrangler deployuses Durable Objects with SQLite migrations. progress notifications and task primitives don't work in the Workers runtime.
transports
transport | use case | command |
STDIO (default) | Claude Desktop, Cursor, local clients |
|
HTTP | remote/multi-session |
|
Cloudflare Workers | edge deployment |
|
internals
single API client (src/api/client.ts) that uses curl via spawnSync instead of native fetch — works around an ARM64 macOS socket issue where Node.js fetch gets EHOSTUNREACH on LAN IPs. blocks the event loop, but reliable.
src/
index.ts — MCP server factory, transport setup
config.ts — env var loading, UUID validation
tools/
index.ts — all 12 tool definitions (Zod schemas + handlers)
api/
client.ts — VibeClient singleton, curl-based HTTP
types.ts — TypeScript interfaces for API responses
resources.ts — MCP resources, subscription manager with SHA-256 change detection
tasks.ts — MCP task primitive integration (experimental)
utils/
formatter.ts — response formatting
progress.ts — progress notification emitter
worker.ts — Cloudflare Workers entry point (compiled by Wrangler, excluded from tsconfig)dev
pnpm dev # hot reload via tsx
pnpm build # compile to dist/
pnpm start # run dist/index.js
pnpm clean # remove dist/license
MIT
Available Tools
12 toolscancel_queueB
Cancel a queued message.
Remove pending message from queue.
cancel_queue(session_id="sess123...")
Inputs: session_id (required).
create_taskA
Create a new task.
Add a task to the project. Supports @tagname expansion in description.
create_task(title="Add user auth", description="Implement OAuth with @google-auth")
Inputs: title (required), description.
delete_taskA
Delete a task permanently.
Remove a task from the project. Cannot be undone.
delete_task(task_id="abc123...")
Inputs: task_id (required).
get_contextA
Get current workspace context.
Check active project, task, and workspace info.
<when_not_to_use>
To list tasks → use list_tasks
To get task details → use get_task </when_not_to_use>
get_context()
Inputs: no named parameters.
get_queue_statusB
Check if a message is queued for a session.
See pending message when executor is busy.
get_queue_status(session_id="sess123...")
Inputs: session_id (required).
get_sessionA
Get session details.
Check which executor is assigned and session state.
get_session(session_id="sess123...")
Inputs: session_id (required).
get_taskA
Get task details.
View full task information including description.
get_task(task_id="abc123...")
Inputs: task_id (required).
list_sessionsA
List sessions in a workspace.
See all executor sessions for a workspace. Each session tracks conversation with one executor.
list_sessions(workspace_id="xyz789...")
Inputs: workspace_id (required).
list_tasksA
List tasks in the project.
View all tasks or filter by status (todo, inprogress, inreview, done, cancelled).
list_tasks(status="inprogress", limit=10)
Inputs: limit, status.
send_messageA
Send a message to a coding agent session.
Send follow-up instructions to an active session. Auto-queues if executor is busy.
send_message(session_id="sess123...", prompt="Add error handling")
Inputs: prompt (required), session_id (required), variant, executor, +1 more.
start_workspace_sessionB
Start a coding session for a task.
Launch a coding agent to work on a task. Creates workspace + session.
start_workspace_session(task_id="abc123...", executor="claude_code")
Inputs: task_id (required), executor (required), variant, base_branch.
update_taskB
Update task properties.
Change task title, description, or status.
update_task(task_id="abc123...", status="done")
Inputs: task_id (required), title, status, description.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 12 tools
Each tool targets a distinct action and resource. Task tools (create, read, update, delete) are clearly separated from session tools (start, list, get, send, cancel, queue status) and context retrieval. No overlap or ambiguity.
All tools follow a consistent verb_noun pattern in snake_case (e.g., create_task, list_sessions, get_queue_status). The verbs are descriptive and the pattern is uniform across the entire set.
With 12 tools, the server covers task management (CRUD), session lifecycle, queue operations, and workspace context. The count feels well-balanced for the domain without being excessive or sparse.
Task CRUD is fully covered. Sessions have start, list, get, and message sending. Lacks an explicit end/close session tool, but the current set supports core workflows. Minor gap, but agents can manage via cancel_queue or context.
Maintenance
Related MCP Connectors
Remote MCP for Kanban AI boards—manage projects, tasks, and comments from AI tools.
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
AI-native Kanban board — connect Claude to claim, work and move your tasks over MCP.
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that connects AI assistants to Kanban Tool for reading and managing boards, tasks, and workflows via natural language.2627 PyPIMIT
- AlicenseAqualityBmaintenanceMCP server that connects AI coding tools to VibeCompass projects for reading context and writing decisions, conflicts, and session notes.1056 npmMIT
- AlicenseNot gradedqualityCmaintenanceMCP server that enables AI coding agents to communicate, share state, and coordinate work in real time via MCP tools or REST API.79 npm10MIT
- AlicenseBqualityDmaintenanceAn MCP server that enables AI assistants to interact with Kan boards through the Kanban API, allowing tasks like viewing and managing boards via natural language.7814 npmMIT