README.md
A full-featured Kanban board for AI coding agents to manage projects.
Kanban MCP
A full-featured Kanban board with integrated Model Context Protocol (MCP) server, allowing AI coding agents to manage projects and tasks programmatically.
Tech Stack
| Layer | Technology |
|---|---|
| Framework | Next.js 16 (App Router) |
| Language | TypeScript |
| Database | SQLite + Drizzle ORM |
| UI | shadcn/ui + Tailwind CSS v4 |
| State | Zustand |
| Drag & Drop | @dnd-kit |
| MCP | @modelcontextprotocol/sdk |
Features
- Kanban Board — Drag-and-drop tasks across Backlog, Todo, In Progress, In Review, Done
- Dashboard — Summary cards, donut charts (status/priority), 14-day trend bar chart, project breakdown
- Sub-tasks — Checklist-style sub-tasks with progress bar
- Labels — Custom color labels per project
- Comments — Timestamped comment threads on tasks
- Activity Log — Full history of task changes
- Search & Filter — Real-time search + priority filter on board
- CSV Export — Export all tasks or per-project
- Dark Mode — Enabled by default
- MCP Server — 13 tools + 4 resources for AI agent integration
Getting Started
Prerequisites
- Node.js 18+
- npm
Installation
git clone https://github.com/dzikrihilman/kanban-mcp.git
cd kanban-mcp
npm install
Database Setup
npm run db:generate
npm run db:migrate
Run Development Server
npm run dev
Open http://localhost:3000.
MCP Server
The MCP server exposes project and task management as tools for AI coding agents (Claude, Cursor, Windsurf, etc).
Available Tools
| Tool | Description |
|---|---|
list_projects |
List all projects with task counts |
get_project |
Get project details |
create_project |
Create new project |
update_project |
Update project fields |
delete_project |
Delete project and all tasks |
list_tasks |
List tasks (filter by status/priority) |
get_task |
Get task with comments |
create_task |
Create task with all fields |
update_task |
Update task with activity logging |
delete_task |
Delete task |
move_task |
Move task between columns |
add_comment |
Add comment to task |
search_tasks |
Search by keyword |
get_dashboard_summary |
Full dashboard statistics |
Available Resources
| URI | Description |
|---|---|
kanban://projects |
All projects |
kanban://project/{id} |
Project detail |
kanban://project/{id}/tasks |
Project tasks |
kanban://task/{id} |
Task with comments |
Run MCP Server Standalone
npm run mcp:start
Configure MCP Client
Add the following to your MCP client configuration:
Claude Desktop (claude_desktop_config.json):
{
"mcpServers": {
"kanban-mcp": {
"command": "npx",
"args": ["tsx", "/absolute/path/to/kanban-mcp/src/mcp-server/index.ts"]
}
}
}
Cursor / Windsurf / Antigravity (mcp_config.json):
{
"mcpServers": {
"kanban-mcp": {
"command": "npx",
"args": ["tsx", "/absolute/path/to/kanban-mcp/src/mcp-server/index.ts"]
}
}
}
Replace
/absolute/path/to/kanban-mcpwith the actual path to your project.
Usage Example
Once configured, your AI agent can:
"Create a new project called 'My App' and add 3 tasks to it"
"Move task X to in_progress"
"Show me the dashboard summary"
"Export all tasks as CSV"
Scripts
| Script | Description |
|---|---|
| `npm r |
Tools (14)
list_projectsList all projects with task countsget_projectGet project detailscreate_projectCreate new projectupdate_projectUpdate project fieldsdelete_projectDelete project and all taskslist_tasksList tasks (filter by status/priority)get_taskGet task with commentscreate_taskCreate task with all fieldsupdate_taskUpdate task with activity loggingdelete_taskDelete taskmove_taskMove task between columnsadd_commentAdd comment to tasksearch_tasksSearch by keywordget_dashboard_summaryFull dashboard statisticsConfiguration
claude_desktop_config.json
{"mcpServers": {"kanban-mcp": {"command": "npx", "args": ["tsx", "/absolute/path/to/kanban-mcp/src/mcp-server/index.ts"]}}}Try it
→Create a new project called 'Website Redesign' and add 3 tasks to it.
→Move the task with ID 5 to the 'In Progress' column.
→Show me the dashboard summary to see my current project progress.
→Search for all tasks related to 'authentication' and list them.
→Add a comment to task 12 saying 'Waiting for design assets'.