Skip to main content
Glama

@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

npx @aixlab/kanbn-mcp

Global install

npm install -g @aixlab/kanbn-mcp
kanbn-mcp

Related MCP server: Another Planka MCP

Configuration

The server requires the following environment variables:

Variable

Description

API_BASE_URL

Base URL of your Kan instance (e.g. https://kan.example.com/api)

BEARER_TOKEN_AUTHORIZATION

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 tools
attachment-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-deleteC

Deletes a member from a workspace (Tags: Workspaces)

Inputs: workspacePublicId (required), memberPublicId (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-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

    B3.2/5.0

    Scored across 78 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      A Model Context Protocol server that provides AI assistants with structured access to kanban board functionality for managing tasks, columns, labels, and sprints.
      12 npm
      2
      MIT
    • A
      license
      B
      quality
      D
      maintenance
      An 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.
      45
      39 PyPI
      86
      MIT