sc-planka-mcp

MCP (Model Context Protocol) Server for Planka — the open-source kanban board.

Allows AI agents to read, create, update and manage projects, boards, lists, cards, tasks, comments, attachments and labels via the Planka REST API.

Quick start

1. Configure environment variables

| Variable | Required | Description | | ----------------- | -------- | ------------------------------------------------------------ | | PLANKA_BASE_URL | Yes | Your Planka instance URL (e.g. https://planka.example.com) | | PLANKA_USER | Yes | Email or username for Planka login | | PLANKA_PASSWORD | Yes | Password for Planka login |

Authentication is automatic — the server logs in with username/password on the first API call and reuses the token for the session.

2. Run with npx

PLANKA_BASE_URL=https://planka.example.com \
[email protected] \
PLANKA_PASSWORD=secret \
npx sc-planka-mcp

3. Add to your MCP client

VS Code / Copilot (.vscode/mcp.json):

{
  "servers": {
    "planka": {
      "command": "npx",
      "args": ["-y", "sc-planka-mcp"],
      "env": {
        "PLANKA_BASE_URL": "https://planka.example.com",
        "PLANKA_USER": "[email protected]",
        "PLANKA_PASSWORD": "secret"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "planka": {
      "command": "npx",
      "args": ["-y", "sc-planka-mcp"],
      "env": {
        "PLANKA_BASE_URL": "https://planka.example.com",
        "PLANKA_USER": "[email protected]",
        "PLANKA_PASSWORD": "secret"
      }
    }
  }
}

Available tools (37)

Projects

| Tool | Description | | ----------------------- | ----------------------------------------------- | | planka_list_projects | List all accessible projects | | planka_get_project | Get project details with boards and memberships | | planka_create_project | Create a new project | | planka_update_project | Update project properties | | planka_delete_project | Delete a project |

Boards

| Tool | Description | | --------------------- | ----------------------------------------- | | planka_get_board | Get board with lists, cards, labels, etc. | | planka_create_board | Create a board in a project | | planka_update_board | Update board properties | | planka_delete_board | Delete a board |

Lists

| Tool | Description | | -------------------- | --------------------------- | | planka_get_list | Get list with all its cards | | planka_create_list | Create a list in a board | | planka_update_list | Update list properties | | planka_delete_list | Delete a list | | planka_sort_list | Sort cards in a list |

Cards

| Tool | Description | | -------------------------------- | ------------------------------------------ | | planka_get_card | Get card details with tasks, labels, etc. | | planka_get_cards | List cards with search/filter | | planka_create_card | Create a card in a list | | planka_update_card | Update card (move, rename, due date, etc.) | | planka_delete_card | Delete a card | | planka_duplicate_card | Duplicate a card | | planka_add_label_to_card | Add a label to a card | | planka_remove_label_from_card | Remove a label from a card | | planka_add_member_to_card | Add a member to a card | | planka_remove_member_from_card | Remove a member |

Tasks & Task Lists

| Tool | Description | | ------------------------- | ------------------------------------ | | planka_create_task_list | Create a checklist on a card | | planka_get_task_list | Get task list with tasks | | planka_update_task_list | Update task list | | planka_delete_task_list | Delete a task list | | planka_create_task | Create a task in a list | | planka_update_task | Update task (complete, assign, etc.) | | planka_delete_task | Delete a task |

Comments

| Tool | Description | | ----------------------- | ----------------------- | | planka_get_comments | Get card comments | | planka_create_comment | Add a comment to a card | | planka_update_comment | Edit a comment | | planka_delete_comment | Delete a comment |

Attachments

| Tool | Description | | ------------------------------- | -------------------------------- | | planka_create_link_attachment | Attach a URL to a card | | planka_create_file_attachment | Upload a file (base64) to a card | | planka_update_attachment | Rename an attachment | | planka_delete_attachment | Delete an attachment |

Labels

| Tool | Description | | --------------------- | ------------------------- | | planka_create_label | Create a label on a board | | planka_update_label | Update a label | | planka_delete_label | Delete a label |

Users & Notifications

| Tool | Description | | --------------------------- | ----------------------------------- | | planka_list_users | List all users | | planka_get_user | Get user details ('me' for current) | | planka_list_notifications | List notifications | | planka_get_notification | Get notification details | | planka_get_board_actions | Board activity history | | planka_get_card_actions | Card activity history |

Development

npm run dev      # Watch mode
npm run build    # Production build
npm start        # Run the server

License

MIT