Planka

io.github.gogogadgetbytesPublished by GitHub account gogogadgetbytesv1.0.0Updated Oct 25, 2026

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

VerifiedSTDIODesktop onlyProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

A local MCP server that lets an assistant read and manage PLANKA kanban boards: projects, boards, lists, cards, tasks, labels and comments.

What you can do
Browse the project, board and list hierarchy and read a board with its cards, lists and labels, or fetch a single card with its tasks and comments. Create, update, move and delete cards, optionally creating a card together with its checklist tasks. Add, update and delete tasks on cards. Create, update and delete board labels and add or remove labels on cards. Add comments to cards and read all comments on a card. Create, update and delete lists.
When to use it
Use it when your team runs PLANKA 2.0 for kanban work and you want an assistant to look up board state, draft or file cards, move them through lists, tick off tasks, or post comments without switching to the web UI.
Requirements
Runs locally via npx from the npm package, so Node.js is needed. Requires a reachable PLANKA 2.0 server URL in PLANKA_BASE_URL and a dedicated agent account's email and password in PLANKA_AGENT_EMAIL and PLANKA_AGENT_PASSWORD. Network access to that server is required.
Before you install
The server stores a PLANKA account password in PLANKA_AGENT_PASSWORD in the client configuration file, so use a dedicated agent account with limited board access rather than a personal login. Many tools write, move or delete board data (cards, tasks, labels, lists, comments), and deletions may be hard to undo. All board content is sent to the configured PLANKA server.

Installation

In SourceWeft

  1. Open Planka in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

PLANKA MCP Server

A Model Context Protocol (MCP) server for PLANKA kanban boards, purpose-built for Claude and other AI agents.

Features

  • Full PLANKA 2.0 API support
  • Type-safe with Zod validation
  • Optimized for agent workflows (combined operations, sensible defaults)
  • 13 tools covering cards, tasks, labels, comments, and lists

Installation

bash
npm install @gogogadgetbytes/planka-mcp

Or run directly:

bash
npx @gogogadgetbytes/planka-mcp

Configuration

Environment Variables

VariableRequiredDescription
PLANKA_BASE_URLYesYour PLANKA server URL
PLANKA_AGENT_EMAILYesAgent user email
PLANKA_AGENT_PASSWORDYesAgent user password

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

json
{  "mcpServers": {    "planka": {      "command": "npx",      "args": ["@gogogadgetbytes/planka-mcp"],      "env": {        "PLANKA_BASE_URL": "https://planka.example.com",        "PLANKA_AGENT_EMAIL": "[email protected]",        "PLANKA_AGENT_PASSWORD": "your-password"      }    }  }}

Claude Code

Add to ~/.claude.json:

json
{  "mcpServers": {    "planka": {      "command": "npx",      "args": ["@gogogadgetbytes/planka-mcp"],      "env": {        "PLANKA_BASE_URL": "https://planka.example.com",        "PLANKA_AGENT_EMAIL": "[email protected]",        "PLANKA_AGENT_PASSWORD": "your-password"      }    }  }}

Available Tools

Navigation

ToolDescription
planka_get_structureGet projects, boards, and lists hierarchy
planka_get_boardGet a board with all cards, lists, and labels

Cards

ToolDescription
planka_create_cardCreate a card (optionally with tasks)
planka_update_cardUpdate card properties
planka_move_cardMove card to different list/position
planka_get_cardGet card details with tasks/comments
planka_delete_cardDelete a card

Tasks

ToolDescription
planka_create_tasksAdd tasks (checklist items) to a card
planka_update_taskUpdate task name or completion
planka_delete_taskDelete a task

Labels

ToolDescription
planka_manage_labelsCreate/update/delete board labels
planka_set_card_labelsAdd/remove labels from a card

Comments

ToolDescription
planka_add_commentAdd a comment to a card
planka_get_commentsGet all comments on a card

Lists

ToolDescription
planka_manage_listsCreate/update/delete lists

Usage Examples

Get board structure

Use planka_get_structure to see all projects and boards

Create a card with tasks

Use planka_create_card with:- listId: "abc123"- name: "Implement feature X"- tasks: ["Research", "Design", "Implement", "Test"]

Move card through workflow

Use planka_move_card to move card from "To Do" to "In Progress"

PLANKA 2.0 Compatibility

This server is designed for PLANKA 2.0 and handles the API differences from 1.x:

  • Card creation includes required type field
  • Label endpoints use /card-labels path
  • Optional fields handled gracefully

Development

bash
# Clonegit clone https://github.com/gogogadgetbytes/planka-mcp.gitcd planka-mcp
# Installnpm install
# Buildnpm run build
# Testnpm test

License

MIT

Links

Source: README.md at commit a42823a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts