How bradrisse/kanban-mcp works
Kanban MCP is an MCP server that lets an AI assistant manage Planka projects and boards. The principal workflow is a client request over stdio, dispatch in the server, and Planka API operations; higher-level tools combine those operations for summaries, card details, and common workflows. The README documents broad management features, including time tracking. Some operation and tool wiring is supported by documentation or filenames rather than sampled implementation, so uncertain call relationships are omitted.
Main entry points: index.ts MCP Server · utils.ts API Request · boards.ts Boards · board-summary.ts Board Summary
Components 18
MCP Server
- MCP Server
index.ts - stdio Transport
index.ts
Workflow Tools
- Board Summary
tools/board-summary.ts - Card Details
tools/card-details.ts - Create Card Bundle
tools/create-card-with-tasks.ts - Workflow Actions
tools/workflow-actions.ts
Kanban Operations
- Projects
operations/projects.ts - Boards
operations/boards.ts - Board Memberships
operations/boardMemberships.ts - Lists
operations/lists.ts - Cards and Time
operations/cards.ts - Tasks
operations/tasks.ts - Comments
operations/comments.ts - Labels
operations/labels.ts
Planka Integration
- API Request
common/utils.ts - Admin Lookup
common/setup.ts
Other components
- AI Assistant
- Planka API
Connections 43
- AI Assistant → stdio Transport: sends MCP requests
- stdio Transport → MCP Server: delivers requests
- MCP Server → stdio Transport: returns results
- MCP Server → Board Summary: dispatches summary
- MCP Server → Card Details: dispatches details
- MCP Server → Create Card Bundle: dispatches creation
- MCP Server → Workflow Actions: dispatches actions
- MCP Server → Projects: dispatches operations
- MCP Server → Boards: dispatches operations
- MCP Server → Board Memberships: dispatches operations
- MCP Server → Lists: dispatches operations
- MCP Server → Cards and Time: dispatches operations
- MCP Server → Tasks: dispatches operations
- MCP Server → Comments: dispatches operations
- MCP Server → Labels: dispatches operations
- Board Summary → Boards: reads board
- Board Summary → Lists: reads lists
- Board Summary → Cards and Time: reads cards
- Board Summary → Tasks: reads tasks
- Board Summary → Comments: reads comments
- Board Summary → Labels: reads labels
- Create Card Bundle → Cards and Time: creates card
- Create Card Bundle → Tasks: creates tasks
- Create Card Bundle → Comments: adds comment
- Workflow Actions → Cards and Time: reads and moves
- Workflow Actions → Boards: reads board
- Workflow Actions → Lists: reads lists
- Workflow Actions → Tasks: updates tasks
- Workflow Actions → Comments: adds comment
- Boards → Lists: creates defaults
- Boards → Labels: creates defaults
- Boards → Board Memberships: adds admin member
- Boards → Admin Lookup: looks up admin
- Projects → API Request: calls API helper
- Boards → API Request: calls API helper
- Board Memberships → API Request: calls API helper
- Lists → API Request: calls API helper
- Cards and Time → API Request: calls API helper
- Tasks → API Request: calls API helper
- Comments → API Request: calls API helper
- Labels → API Request: calls API helper
- Admin Lookup → API Request: looks up users
- API Request → Planka API: sends API requests