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.
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
Project Structure
Getting Started
Prerequisites
- Node.js (v18+ recommended)
- MongoDB instance
Setup
- Clone the repository:
- Install dependencies:
- Configure environment variables:
- Create a
.env
file in the root directory with:
- Create a
- Build the project:
- Start 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-analytics
prompt. - See
src/index.ts
for 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
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables users to manage Kanban-style tasks with priorities, tags, and statuses (todo, in progress, done) through natural language. Provides task analytics including lead time, cycle time, and status distribution with MongoDB storage.
Related MCP Servers
- AsecurityAlicenseAqualityProvides comprehensive tools for managing GitHub projects, milestones, tasks, and sprints. This server integrates deeply with GitHub Projects V2, offering features like automated kanban workflows, sprint planning, and custom field management.Last updated -461059TypeScriptMIT License
- -securityAlicense-qualityEnables advanced todo list management and content organization using Notion's API, supporting features like creating databases, dynamic filtering, and collaborative task tracking.Last updated -27PythonMIT License
- AsecurityAlicenseAqualityProvides API access to a locally-hosted task management system with features for creating, updating, and organizing tasks, including support for urgency levels, effort estimates, subtasks, and bi-directional sync with Obsidian markdown files.Last updated -128PythonMIT License
- -securityFlicense-qualityA task tracking and backlog management tool that enables AI assistants to create, organize, and track issues and tasks with status workflow through MCP protocol.Last updated -1Python