Kanban MCP Server
Provides persistent storage for Kanban tasks and user data, enabling task management with priorities, tags, and status tracking across todo, in-progress, and done states.
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., "@Kanban MCP Server show me tasks due this week and their status distribution"
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.
Kanban-MCP
A Model Context Protocol (MCP) server for managing Kanban-style tasks with analytics, built using Node.js, TypeScript, and MongoDB (via Mongoose).
Features
Create, update, and manage tasks with priorities, tags, and statuses (todo, inProgress, done)
Task analytics: lead time, cycle time, and status distribution
MCP-compliant server with stdio transport
MongoDB integration with user-based task filtering
Task caching for performance
Related MCP server: KanbanX MCP Server
Project Structure
Kanban-MCP/
├── src/
│ ├── index.ts # Main MCP server logic
│ └── utils/
│ ├── mongoose.ts # Mongoose DB utilities
│ ├── Task.d.ts # Task type definitions
│ └── User.d.ts # User type definitions
├── build/ # Compiled JS output
├── .vscode/mcp.json # MCP server config
├── package.json # NPM dependencies and scripts
├── tsconfig.json # TypeScript configGetting Started
Prerequisites
Node.js (v18+ recommended)
MongoDB instance
Setup
Clone the repository:
git clone <repo-url> cd Kanban-MCPInstall dependencies:
npm installConfigure environment variables:
Create a
.envfile in the root directory with:MONGODB_URI=your_mongodb_uri KANBAN_USERNAME=your_username DBNAME=your_db_name
Build the project:
npm run buildStart the MCP server: When starting the repo, VS Code will prompt you to start the MCP server.
Usage
The server exposes MCP tools for creating, moving, and prioritizing tasks.
Analytics can be retrieved via the
tasks-analyticsprompt.See
src/index.tsfor tool and prompt definitions.
Development
Source code is in
src/, compiled output inbuild/.TypeScript is used for type safety and modern JS features.
Use the provided VS Code MCP config for local development.
License
MIT
Tech Stack
Node.js: JavaScript runtime for server-side logic
TypeScript: Strongly-typed language for safer code
MongoDB: NoSQL database for task storage
Mongoose: ODM for MongoDB integration
VS Code MCP: Integration for Model Context Protocol tools
Available Tools
4 toolsadd-tagC
add tags to a tasks
Inputs: task_tag (required), task_id (required).
create-taskC
create a new todo task
Inputs: task_title (required), description (required).
move-taskB
move a task to a different status
Inputs: task_id (required), new_status (required).
set-prioityC
set a task to a different priority
Inputs: task_id (required), new_priority (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: add-tag modifies metadata, create-task creates new items, move-task changes workflow status, and set-prioity adjusts priority levels. There is no overlap in functionality, making tool selection straightforward for an agent.
The naming is mixed: add-tag and move-task use verb-noun patterns, while create-task and set-prioity use verb-noun but with inconsistent spelling (e.g., 'prioity' vs. 'priority'). This reduces predictability, though the tools remain readable.
With 4 tools, the count is appropriate for a kanban server, covering core operations like task creation, status movement, tagging, and priority setting. It is slightly lean but reasonable for the domain, lacking only minor features like task deletion or listing.
The toolset covers basic CRUD-like operations but has notable gaps: there is no tool to delete tasks, list tasks, or retrieve task details. This could lead to agent failures when full lifecycle management is needed, though core workflows are supported.
Related MCP Connectors
A todo and task board in kanban form, driven from chat with full CRUD.
Task & board management for AI agents + humans. Kanban, comments, digests via MCP.
Kanban boards your AI agent can use: add, complete, move and recall tasks with your team.
Manage projects, tasks, time tracking, and team collaboration through natural language.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables AI-powered task management with Google Gemini integration, providing CRUD operations, task analytics, CSV export, and natural language interaction for comprehensive project management.-
- AlicenseNot gradedqualityDmaintenanceEnables users to manage a personal Kanban board with tasks, subtasks, notes, and code clips using natural language via the Model Context Protocol.1MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to manage tasks in a kanban board organized as markdown files, with operations to create, update, delete, move tasks, manage lanes, and get statistics.1MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to manage Kanban tasks, boards, teams, and checklists via natural language, with full CRUD operations and live updates.MIT