# planka [Health: Active]

**Category:** 📋 Product Management  
**Repository:** https://github.com/gogogadgetbytes/planka-mcp  
**GitHub Stars:** 12  
**npm Downloads (last month):** 379  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/planka

## Description
MCP server for PLANKA kanban boards. Full CRUD for cards, tasks, comments, and labels.

## Tools
Capabilities this server exposes over MCP:

- **planka_get_structure** — Get the full project/board/list structure. Use this to understand what projects and boards exist before working with cards.
- **planka_get_board** — Get a board with all its lists, cards, and labels. Use this to see everything on a board.
- **planka_create_card** — Create a new card on a board. Optionally add tasks (checklist items) at the same time.
- **planka_get_card** — Get full details of a card including tasks, comments, labels, and attachments.
- **planka_update_card** — Update a card's properties (name, description, due date, completion status).
- **planka_move_card** — Move a card to a different list or position. Use this for workflow transitions (e.g., 'To Do' -> 'In Progress').
- **planka_delete_card** — Permanently delete a card. This cannot be undone.
- **planka_create_tasks** — Add one or more tasks (checklist items) to a card.
- **planka_update_task** — Update a task's name or completion status.
- **planka_delete_task** — Delete a task from a card.
- **planka_manage_labels** — Create, update, or delete labels on a board.
- **planka_set_card_labels** — Add or remove labels from a card.
- **planka_add_comment** — Add a comment to a card. Use this for status updates, notes, or agent activity logs.
- **planka_get_comments** — Get all comments on a card.
- **planka_manage_lists** — Create, update, or delete lists on a board.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "planka": {
    "command": "npx",
    "args": ["-y","@gogogadgetbytes/planka-mcp"],
    "env": {
      "PLANKA_BASE_URL": "",
      "PLANKA_AGENT_EMAIL": "",
      "PLANKA_AGENT_PASSWORD": ""
    }
  }
}
```

**Requires environment variables:** `PLANKA_BASE_URL`, `PLANKA_AGENT_EMAIL`, `PLANKA_AGENT_PASSWORD` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## What the planka MCP server does

The planka MCP server gives an MCP-compatible agent access to PLANKA kanban data and actions. It works with projects, boards, lists, cards, tasks, labels, and comments, allowing an agent to inspect existing work and make changes through structured tool calls.

Navigation tools return the project, board, and list hierarchy or retrieve a board with its cards, lists, and labels. Card operations cover creation, property updates, movement between lists and positions, detailed retrieval, and deletion. A new card can optionally include tasks at creation time.

Task tools manage checklist items on cards. Agents can add several tasks, change a task name or completion state, and remove tasks. Label tools handle board labels and the labels assigned to individual cards. Comment tools add comments and retrieve all comments associated with a card. List management supports creating, updating, and deleting lists.

## How it works

The server runs as an MCP process and calls the PLANKA API using the configured agent account. Inputs are validated with Zod, and the implementation is intended for PLANKA 2.0 API behavior. That includes supplying the required card type during card creation, using the PLANKA 2.0 card-label endpoint, and handling optional fields without requiring them in every request.

An agent can first inspect the available workspace with `planka_get_structure`, locate a board or list, and then use the relevant mutation tool. For example, a workflow can create a card with checklist items, move the card as work progresses, apply labels, and append status comments. The server does not describe a separate synchronization layer or local data store; its documented role is to expose PLANKA operations over MCP.

## Setup and configuration

Install the package with npm or invoke it directly with npx:

```bash
npm install @gogogadgetbytes/planka-mcp
npx @gogogadgetbytes/planka-mcp
```

Running the package requires three environment variables:

- `PLANKA_BASE_URL`: The URL of the PLANKA server.
- `PLANKA_AGENT_EMAIL`: The email address for the agent user.
- `PLANKA_AGENT_PASSWORD`: The agent user's password.

The README provides configuration examples for Claude Desktop and Claude Code. Both launch the package through `npx` and pass these values in the server's environment. The supplied credentials therefore need an agent account that can access the intended PLANKA workspace.

For local development, the repository instructions use `npm install`, `npm run build`, and `npm test` after cloning the project.

## Tools and capabilities

The planka MCP server groups its tools by the type of PLANKA object they operate on:

- Navigation: inspect the project, board, and list hierarchy or fetch a complete board view.
- Cards: create, read, update, move, and delete cards; creation may include tasks.
- Tasks: add checklist items, update their names or completion status, and delete them.
- Labels: create, update, or delete board labels and add or remove labels on cards.
- Comments: add comments to cards and retrieve their comments.
- Lists: create, update, or delete lists.

These operations support common agent workflows such as finding a destination list, creating a work item with a checklist, moving it through a board, and recording progress in comments.

## Limitations and notes

The documentation targets PLANKA 2.0 and specifically calls out differences from version 1.x. Compatibility with PLANKA 1.x is not stated. The server also requires PLANKA URL and agent credentials; without all three configuration variables, the documented setup is incomplete.

The README explicitly documents Claude Desktop and Claude Code configuration. It does not provide client-specific setup instructions for other MCP clients.

_Full upstream README: https://allmcps.com/mcp/planka/readme_