@aix/kanbn-mcp
Allows integration with VS Code (GitHub Copilot) to manage Kan boards.
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., "@@aix/kanbn-mcp list all boards in my workspace"
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.
@aixlab/kanbn-mcp
An MCP (Model Context Protocol) server for the Kan Kanban API. Allows AI assistants like Claude, Cursor, and others to interact with your Kan boards directly.
Installation
Via npx (recommended – no installation needed)
npx @aixlab/kanbn-mcpGlobal install
npm install -g @aixlab/kanbn-mcp
kanbn-mcpRelated MCP server: Another Planka MCP
Configuration
The server requires the following environment variables:
Variable | Description |
| Base URL of your Kan instance (e.g. |
| Your Kan API key |
You can set these in a .env file or pass them directly as environment variables.
Usage with Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"kan": {
"command": "npx",
"args": ["-y", "@aixlab/kanbn-mcp"],
"env": {
"API_BASE_URL": "https://kan.example.com/api",
"BEARER_TOKEN_AUTHORIZATION": "your-api-key-here"
}
}
}
}Usage with VS Code (GitHub Copilot)
Add this to your .vscode/mcp.json:
{
"servers": {
"kan": {
"command": "npx",
"args": ["-y", "@aixlab/kanbn-mcp"],
"env": {
"API_BASE_URL": "https://kan.example.com/api",
"BEARER_TOKEN_AUTHORIZATION": "your-api-key-here"
}
}
}
}License
MIT
Available Tools
78 toolsattachment-confirmC
Confirms an attachment upload and saves the record to the database (Tags: Attachments)
Inputs: cardPublicId (required), requestBody (required).
attachment-deleteC
Soft deletes an attachment (Tags: Attachments)
Inputs: attachmentPublicId (required).
attachment-generateUploadUrlB
Generates a presigned URL for uploading an attachment to S3 (Tags: Attachments)
Inputs: cardPublicId (required), requestBody (required).
board-allB
Retrieves all boards for a given workspace (Tags: Boards)
Inputs: workspacePublicId (required), type, archived.
board-byIdC
Retrieves a board by its public ID (Tags: Boards)
Inputs: boardPublicId (required), members, labels, lists, +2 more.
board-bySlugC
Retrieves a board by its slug within a specific workspace (Tags: Boards)
Inputs: workspaceSlug (required), boardSlug (required), members, labels, +2 more.
board-checkSlugAvailabilityC
Checks if a board slug is available (Tags: Boards)
Inputs: boardPublicId (required), boardSlug (required).
board-createC
Creates a new board for a given workspace (Tags: Boards)
Inputs: workspacePublicId (required), requestBody (required).
board-deleteC
Deletes a board by its public ID (Tags: Boards)
Inputs: boardPublicId (required).
board-updateC
Updates a board by its public ID (Tags: Boards)
Inputs: boardPublicId (required), requestBody (required).
card-addCommentC
Adds a comment to a card (Tags: Cards)
Inputs: cardPublicId (required), requestBody (required).
card-addOrRemoveLabelC
Adds or removes a label from a card (Tags: Cards)
Inputs: cardPublicId (required), labelPublicId (required).
card-addOrRemoveMemberC
Adds or removes a member from a card (Tags: Cards)
Inputs: cardPublicId (required), workspaceMemberPublicId (required).
card-byIdB
Retrieves a card by its public ID (Tags: Cards)
Inputs: cardPublicId (required).
card-createB
Creates a new card for a given list (Tags: Cards)
Inputs: requestBody (required).
card-deleteC
Deletes a card by its public ID (Tags: Cards)
Inputs: cardPublicId (required).
card-deleteCommentC
Deletes a comment (Tags: Cards)
Inputs: cardPublicId (required), commentPublicId (required).
card-duplicateC
Duplicates a card to a target list with optional options (Tags: Cards)
Inputs: cardPublicId (required), requestBody (required).
card-getActivitiesC
Retrieves paginated activities for a card with merged frequent changes (Tags: Cards)
Inputs: cardPublicId (required), limit, cursor.
card-updateC
Updates a card by its public ID (Tags: Cards)
Inputs: cardPublicId (required), requestBody (required).
card-updateCommentC
Updates a comment (Tags: Cards)
Inputs: cardPublicId (required), commentPublicId (required), requestBody (required).
checklist-createB
Adds a checklist to a card (Tags: Cards)
Inputs: cardPublicId (required), requestBody (required).
checklist-createItemC
Adds an item to a checklist (Tags: Cards)
Inputs: checklistPublicId (required), requestBody (required).
checklist-deleteB
Deletes a checklist by its public ID (Tags: Cards)
Inputs: checklistPublicId (required).
checklist-deleteItemC
Deletes a checklist item (Tags: Cards)
Inputs: checklistItemPublicId (required).
checklist-updateC
Updates a checklist by its public ID (Tags: Cards)
Inputs: checklistPublicId (required), requestBody (required).
checklist-updateItemC
Updates a checklist item (title/completed) (Tags: Cards)
Inputs: checklistItemPublicId (required), requestBody (required).
health-healthA
Returns the health status of the application and its dependencies (Tags: Health)
Inputs: no named parameters.
health-statsB
Returns statistics about the application (workspaces, users, cards, etc.) (Tags: Health)
Inputs: no named parameters.
import-github-getProjectsA
Retrieves all projects from GitHub (Tags: Integrations)
Inputs: no named parameters.
import-github-importProjectsC
Imports projects from GitHub (Tags: Imports)
Inputs: requestBody (required).
import-trello-getBoardsB
Retrieves all boards from Trello (Tags: Integrations)
Inputs: no named parameters.
import-trello-importBoardsC
Imports boards from Trello (Tags: Imports)
Inputs: requestBody (required).
integration-disconnectC
Disconnects an integration (Tags: Integration)
Inputs: requestBody (required).
integration-getAuthorizationUrlC
Retrieves the authorization URL for an integration (Tags: Integration)
Inputs: provider (required).
integration-providersA
Retrieves all integration providers for the user (Tags: Integration)
Inputs: no named parameters.
label-byPublicIdB
Retrieves a label by its public ID (Tags: Labels)
Inputs: labelPublicId (required).
label-createB
Creates a new label (Tags: Labels)
Inputs: requestBody (required).
label-deleteC
Deletes a label by its public ID (Tags: Labels)
Inputs: labelPublicId (required).
label-updateB
Updates a label by its public ID (Tags: Labels)
Inputs: labelPublicId (required), requestBody (required).
list-createC
Creates a new list for a given board (Tags: Lists)
Inputs: requestBody (required).
list-deleteB
Deletes a list by its public ID (Tags: Lists)
Inputs: listPublicId (required).
list-updateC
Updates a list by its public ID (Tags: Lists)
Inputs: listPublicId (required), requestBody (required).
member-acceptInviteLinkB
Accepts an invitation via invite link (Tags: Invites)
Inputs: requestBody (required).
member-createInviteLinkC
Create invite link for a workspace (Tags: Invites)
Inputs: workspacePublicId (required).
member-deactivateInviteLinkC
Deactivates the invite link for a workspace (Tags: Invites)
Inputs: workspacePublicId (required).
member-deleteC
Deletes a member from a workspace (Tags: Workspaces)
Inputs: workspacePublicId (required), memberPublicId (required).
member-getActiveInviteLinkC
Gets the active invite link for a workspace (Tags: Invites)
Inputs: workspacePublicId (required).
member-getInviteByCodeC
Get invite information by invite code (Tags: Invites)
Inputs: inviteCode (required).
member-inviteB
Invites a member to a workspace (Tags: Workspaces)
Inputs: workspacePublicId (required), requestBody (required).
member-updateRoleC
Updates a member's role in a workspace (Tags: Workspaces)
Inputs: workspacePublicId (required), memberPublicId (required), requestBody (required).
permission-getMemberPermissionsC
Get a specific member's permissions in a workspace (Tags: Permissions)
Inputs: workspacePublicId (required), memberPublicId (required).
permission-getMyPermissionsC
Get the current user's permissions in a workspace (Tags: Permissions)
Inputs: workspacePublicId (required).
permission-getRolePermissionsC
Get permissions granted to a specific role in a workspace (Tags: Permissions)
Inputs: workspacePublicId (required), rolePublicId (required).
permission-getWorkspaceRolePermissionsC
Get all roles for a workspace with their granted permissions (Tags: Permissions)
Inputs: workspacePublicId (required).
permission-getWorkspaceRolesC
Get all roles for a workspace (Tags: Permissions)
Inputs: workspacePublicId (required).
permission-grantPermissionC
Grant a specific permission to a member (Tags: Permissions)
Inputs: workspacePublicId (required), memberPublicId (required), requestBody (required).
permission-grantRolePermissionC
Grant a specific permission to a role (Tags: Permissions)
Inputs: workspacePublicId (required), rolePublicId (required), requestBody (required).
permission-resetMemberPermissionsC
Clears all custom permission overrides for a member so their effective permissions come only from their role (Tags: Permissions)
Inputs: workspacePublicId (required), memberPublicId (required).
permission-resetWorkspaceMemberPermissionsA
Clears all custom permission overrides for all members in a workspace so their effective permissions come only from their roles (Tags: Permissions)
Inputs: workspacePublicId (required).
permission-revokePermissionC
Revoke a specific permission from a member (Tags: Permissions)
Inputs: workspacePublicId (required), memberPublicId (required), requestBody (required).
permission-revokeRolePermissionC
Revoke a specific permission from a role (Tags: Permissions)
Inputs: workspacePublicId (required), rolePublicId (required), requestBody (required).
user-getUserA
Retrieves the currently authenticated user's profile information (Tags: Users)
Inputs: no named parameters.
user-setPasswordB
Sets a password for a user who signed up via magic link and has no password yet (Tags: Users)
Inputs: requestBody (required).
user-updateC
Updates the currently authenticated user's profile information (Tags: Users)
Inputs: requestBody (required).
webhook-createC
Creates a new webhook for a workspace (Tags: Webhooks)
Inputs: workspacePublicId (required), requestBody (required).
webhook-deleteC
Deletes a webhook by its public ID (Tags: Webhooks)
Inputs: workspacePublicId (required), webhookPublicId (required).
webhook-listA
Retrieves all webhooks configured for a workspace (Tags: Webhooks)
Inputs: workspacePublicId (required).
webhook-testC
Sends a test payload to a webhook (Tags: Webhooks)
Inputs: workspacePublicId (required), webhookPublicId (required).
webhook-updateB
Updates a webhook by its public ID (Tags: Webhooks)
Inputs: workspacePublicId (required), webhookPublicId (required), requestBody (required).
workspace-allA
Retrieves all workspaces for the authenticated user (Tags: Workspaces)
Inputs: no named parameters.
workspace-byIdB
Retrieves a workspace by its public ID (Tags: Workspaces)
Inputs: workspacePublicId (required).
workspace-bySlugC
Retrieves a workspace by its slug (Tags: Workspaces)
Inputs: workspaceSlug (required).
workspace-checkSlugAvailabilityC
Checks if a workspace slug is available (Tags: Workspaces)
Inputs: workspaceSlug (required).
workspace-createC
Creates a new workspace (Tags: Workspaces)
Inputs: requestBody (required).
workspace-deleteC
Deletes a workspace by its public ID (Tags: Workspaces)
Inputs: workspacePublicId (required).
workspace-searchC
Searches for boards and cards by title within a workspace (Tags: Workspaces)
Inputs: workspacePublicId (required), query (required), limit.
workspace-updateB
Updates a workspace by its public ID (Tags: Workspaces)
Inputs: workspacePublicId (required), requestBody (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 78 tools
Tools are clearly grouped by resource (board, card, checklist, etc.) with distinct actions. Even closely related tools like the various member invitation tools have descriptions that clearly differentiate them. No ambiguous overlap.
Uses a consistent [category]-[action] pattern (e.g., card-create, board-byId). Even nested categories like import-github-getProjects follow the pattern. Only minor variation like health-health is still predictable within its own group.
78 tools is high but justified by the comprehensive coverage of a kanban/project management system (boards, cards, checklists, permissions, webhooks, imports, etc.). Each tool has a clear purpose, though some consolidation might be possible.
Covers most CRUD operations and many domain-specific actions (comments, checklists, labels, permissions, webhooks, imports). Minor gaps like a dedicated card move tool are missing, but card update can change list position. Overall very thorough.
Related MCP Connectors
One MCP server for the services your AI needs: memory, files, Microsoft 365, kanban and more.
Remote MCP for Kanban AI boards—manage projects, tasks, and comments from AI tools.
AI-native Kanban board — connect Claude to claim, work and move your tasks over MCP.
MCP server that lets AI assistants use all OneSchema features exposed via the public API.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that provides AI assistants with structured access to kanban board functionality for managing tasks, columns, labels, and sprints.12 npm2MIT
- FlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI assistants to interact with self-hosted Planka boards through the Planka REST API. It allows users to list, search, create, and update projects, boards, and cards using natural language.3-
- AlicenseAqualityDmaintenanceAn MCP server that connects AI assistants to Kanban Tool for reading and managing boards, tasks, and workflows via natural language.26MIT
- AlicenseBqualityDmaintenanceAn MCP server that provides a database-backed kanban board with 40+ tools for AI agents to track issues, features, todos, epics, and diary entries across projects, including status workflows, relationships, and semantic search.4539 PyPI86MIT