Skip to main content
Glama

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_mcp

Tools

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 tools
add_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

    C2.9/5.0

    Scored across 56 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers