home / mcp / planka mcp server

PLANKA MCP Server

MCP server exposing PLANKA 2.0 data sources and actions for AI agents to manage cards, tasks, labels, comments, and lists.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run and connect to a PLANKA MCP server that provides a complete, type-safe interface for managing PLANKA kanban boards. This server enables AI agents to interact with boards, cards, tasks, labels, and comments through a structured, protocol-friendly API with sensible defaults tailored for agent workflows.

How to use

To use this MCP server, run it locally using the provided command and point your MCP client (such as Claude or another agent) at the server. You will gain access to a rich set of tools for exploring board structure, creating and updating cards, managing tasks, labels, comments, and lists, and moving items through your workflow. Configure your client with the connection details and required environment variables, then invoke the available tools to perform common Kanban operations.

How to install

Prerequisites: ensure you have Node.js and npm installed on your machine.

# Install the MCP server package locally
npm install @gogogadgetbytes/planka-mcp

# Or run the MCP server directly without installing globally
npx @gogogadgetbytes/planka-mcp

Available tools

planka_get_structure

Get projects, boards, and lists hierarchy

planka_get_board

Get a board with all cards, lists, and labels

planka_create_card

Create a card (optionally with tasks)

planka_update_card

Update card properties

planka_move_card

Move card to different list/position

planka_get_card

Get card details with tasks/comments

planka_delete_card

Delete a card

planka_create_tasks

Add tasks (checklist items) to a card

planka_update_task

Update task name or completion

planka_delete_task

Delete a task

planka_manage_labels

Create/update/delete board labels

planka_set_card_labels

Add/remove labels from a card

planka_add_comment

Add a comment to a card

planka_get_comments

Get all comments on a card

planka_manage_lists

Create/update/delete lists