planka-mcp
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., "@planka-mcp Show me all cards in the 'Product Launch' board"
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.
planka-mcp
MCP server for Planka project management. Provides tools for managing projects, boards, lists, cards, tasks, labels, comments, stopwatches, and memberships.
Configuration
Set these environment variables:
PLANKA_BASE_URL— The base URL of your Planka instance (e.g.https://planka.example.com)PLANKA_API_TOKEN— Your Planka API token (from Account → API Tokens)
Related MCP server: Planka MCP Server
Development
# Install dependencies
uv sync
# Run the MCP server
uv run python -m planka_mcpTools
This server exposes 50+ MCP tools covering:
Projects: get/create/update/delete
Boards: get/create/update/delete, summaries
Lists: get/create/update/delete
Cards: get/create_cards/update_cards/move_cards/delete_cards/duplicate (all batch-aware), details, parent-child, file attachments
Tasks: get/create_tasks/update/delete_tasks/toggle complete
Labels: get/create/update/delete, add/remove from cards
Comments: get/create/update/delete
Stopwatches: start/stop/get/reset
Memberships: get/create/update/delete
Users: list users
Available Tools
56 toolsadd_label_to_cardAdd Label To CardC
Add a label to a card.
Inputs: cardId (required), labelId (required). Returns: result
assign_parent_cardAssign Parent CardA
Set the parent card for a card, creating a parent-child (subtask) relationship.
Inputs: id (required), parentCardId (required). Returns: result
attach_file_to_cardAttach File To CardB
Upload a file attachment to a card. Provide the absolute file path.
Inputs: cardId (required), file_path (required), name. Returns: result
batch_create_tasksBatch Create TasksA
Create multiple tasks at once. Each item should have 'cardId' and 'name' keys.
Example: [{"cardId": "123", "name": "Task 1"}, {"cardId": "123", "name": "Task 2"}]
Inputs: tasks (required). Returns: result
complete_taskComplete TaskA
Toggle a task's completion status.
Inputs: id (required). Returns: result
create_boardCreate BoardC
Create a new board in a project.
Inputs: name (required), projectId (required), position. Returns: result
create_cardCreate CardC
Create a new card in a list. dueDate should be ISO 8601 format.
Inputs: name (required), listId (required), dueDate, position, +1 more. Returns: result
create_card_with_tasksCreate Card With TasksB
Create a card with task checklist items. Provide task names as a list of strings.
Inputs: name (required), tasks (required), listId (required), description. Returns: result
create_commentCreate CommentB
Add a comment to a card.
Inputs: text (required), cardId (required). Returns: result
create_labelCreate LabelA
Create a new label on a board. Color should be a Planka color name like 'muddy-grey'.
Inputs: name (required), color (required), boardId (required). Returns: result
create_listCreate ListB
Create a new list on a board. Type can be 'active' or 'closed'.
Inputs: name (required), boardId (required), type, position. Returns: result
create_membershipCreate MembershipB
Add a member to a board. Role can be 'editor' or 'viewer'.
Inputs: userId (required), boardId (required), role. Returns: result
create_projectCreate ProjectC
Create a new project.
Inputs: name (required), description. Returns: result
create_taskCreate TaskB
Create a single task on a card.
Inputs: name (required), cardId (required), position. Returns: result
delete_boardDelete BoardC
Delete a board.
Inputs: id (required). Returns: result
delete_cardDelete CardD
Delete a card.
Inputs: id (required). Returns: result
delete_commentDelete CommentB
Delete a comment.
Inputs: id (required). Returns: result
delete_labelDelete LabelC
Delete a label.
Inputs: id (required). Returns: result
delete_listDelete ListC
Delete a list.
Inputs: id (required). Returns: result
delete_membershipDelete MembershipC
Remove a member from a board.
Inputs: id (required). Returns: result
delete_projectDelete ProjectC
Delete a project.
Inputs: id (required). Returns: result
delete_taskDelete TaskC
Delete a task.
Inputs: id (required). Returns: result
duplicate_cardDuplicate CardC
Duplicate a card into another list (or the same list).
Inputs: id (required), listId (required), position. Returns: result
get_all_cardsGet All CardsA
List all cards in a list.
Inputs: listId (required). Returns: result
get_all_commentsGet All CommentsB
List all comments on a card.
Inputs: cardId (required). Returns: result
get_all_labelsGet All LabelsA
List all labels on a board.
Inputs: boardId (required). Returns: result
get_all_listsGet All ListsC
List all lists (columns) on a board.
Inputs: boardId (required). Returns: result
get_all_membershipsGet All MembershipsA
List all memberships on a board.
Inputs: boardId (required). Returns: result
get_all_tasksGet All TasksA
List all tasks (checklist items) on a card.
Inputs: cardId (required). Returns: result
get_boardGet BoardB
Get a single board by ID.
Inputs: id (required). Returns: result
get_boardsGet BoardsA
List all boards in a project.
Inputs: projectId (required). Returns: result
get_board_summaryGet Board SummaryA
Get a board summary with its lists, card counts, and labels.
Inputs: boardId (required). Returns: result
get_cardGet CardC
Get a single card by ID.
Inputs: id (required). Returns: result
get_card_detailsGet Card DetailsB
Get a card with all its details: tasks, comments, labels, and attachments.
Inputs: cardId (required). Returns: result
get_commentGet CommentA
Get a single comment by ID.
Inputs: id (required). Returns: result
get_listGet ListA
Get a single list by ID.
Inputs: id (required). Returns: result
get_membershipGet MembershipA
Get a single membership by ID.
Inputs: id (required). Returns: result
get_projectGet ProjectA
Get a single project by ID.
Inputs: id (required). Returns: result
get_projectsGet ProjectsA
List all projects the user has access to.
Inputs: page, perPage. Returns: result
get_project_summaryGet Project SummaryB
Get a project summary with all boards, their lists, and card counts.
Inputs: projectId (required). Returns: result
get_stopwatchGet StopwatchA
Get the stopwatch status for a card.
Inputs: id (required). Returns: result
get_taskGet TaskA
Get a single task by ID.
Inputs: id (required). Returns: result
get_usersGet UsersA
List all users the current account can see.
Inputs: no named parameters. Returns: result
move_cardMove CardB
Move a card to another list at a specific position. Use 65535 for end of list.
Inputs: id (required), listId (required), position. Returns: result
remove_label_from_cardRemove Label From CardC
Remove a label from a card.
Inputs: cardId (required), labelId (required). Returns: result
reset_stopwatchReset StopwatchA
Reset the stopwatch on a card (clears accumulated time).
Inputs: id (required). Returns: result
start_stopwatchStart StopwatchA
Start the stopwatch on a card.
Inputs: id (required). Returns: result
stop_stopwatchStop StopwatchB
Stop the stopwatch on a card.
Inputs: id (required). Returns: result
update_boardUpdate BoardC
Update a board's name.
Inputs: id (required), name. Returns: result
update_cardUpdate CardB
Update a card's fields. Only specified fields are updated.
Inputs: id (required), name, dueDate, isClosed, +2 more. Returns: result
update_commentUpdate CommentC
Update a comment's text.
Inputs: id (required), text (required). Returns: result
update_labelUpdate LabelB
Update a label's name and/or color.
Inputs: id (required), name, color. Returns: result
update_listUpdate ListA
Update a list's name and/or type ('active' or 'closed').
Inputs: id (required), name, type. Returns: result
update_membershipUpdate MembershipC
Update a membership's role.
Inputs: id (required), role. Returns: result
update_projectUpdate ProjectA
Update a project's name and/or description.
Inputs: id (required), name, description. Returns: result
update_taskUpdate TaskC
Update a task's name or completion status.
Inputs: id (required), name, isCompleted. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 56 tools
Most tools are clearly separated by resource and action, but some overlap exists: update_task can set completion while complete_task toggles it, and get_card_details bundles comments/tasks/labels that also have dedicated getters. Descriptions are clear enough to avoid major misselection.
Tool names are predominantly snake_case verb_noun and easy to predict. Minor inconsistency: list-all operations use get_projects/get_boards but get_all_lists/get_all_cards/get_all_tasks, and there is no get_label single counterpart.
56 tools is well above the 50+ extreme threshold for an MCP tool surface. Although the Planka domain has many entity types and each tool maps to a distinct operation, the sheer count will make agent tool selection unwieldy.
Core lifecycle coverage is strong across projects, boards, lists, cards, tasks, labels, comments, memberships, and stopwatch. Gaps include no attachment removal/update, no unassign parent-card operation, and no single-label getter, but these are minor compared to the covered surface.
Maintenance
Related MCP Connectors
Remote MCP for Kanban AI boards—manage projects, tasks, and comments from AI tools.
Task & board management for AI agents + humans. Kanban, comments, digests via MCP.
Manage Superlist tasks and lists in plain language from any MCP-compatible AI agent.
Kanban board for teams and coding agents: manage tasks, subtasks, sprints and wiki pages via MCP.
Related MCP Servers
- 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-
- AlicenseBqualityDmaintenanceEnables AI assistants to interact with Planka, a real-time Kanban board application, for managing projects, boards, lists, cards, and more.1044 npm6MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI-powered project management by connecting Claude to Planka kanban boards via 75+ MCP tools for creating, updating, and managing projects, boards, lists, and cards.1GPL 3.0
- AlicenseAqualityDmaintenanceMCP server enabling AI agents to manage PLANKA kanban boards with full CRUD support for cards, tasks, labels, comments, and lists.15141 npm12MIT