MCP Planka Server

You can use the MCP Planka Server to integrate Planka Kanban boards with your MCP-enabled apps. It lets you manage projects, boards, cards, tasks, time tracking, and collaboration through standard MCP endpoints, so you can control Planka from tools like Claude.

How to use

Connect a client to the MCP Planka Server using either a remote HTTP endpoint or a local, in-process MCP setup. You will interact with the server through the provided MCP tools (for projects, boards, lists, cards, labels, tasks, comments, memberships, and a stopwatch) to perform common Kanban operations from your applications.

How to install

# Prerequisites
- Node.js (version 18 or newer)
- npm (comes with Node.js) or yarn

# Optional: install dependencies and prepare project
npm install

# Start options vary by deployment method; choose one and run the corresponding commands below

Install and configure MCP Planka in your environment by choosing one of the supported deployment methods shown in the examples. Below are the concrete commands you will run for local, development, and remote configurations. Adapt the values to your environment.

Configuration and usage notes

Environment variables you will typically set for MCP Planka integration:

• PLANKA_BASE_URL: the base URL of your Planka server (for example http://localhost:3000 or your remote Planka URL)
• PLANKA_AGENT_EMAIL: the authentication email
• PLANKA_AGENT_PASSWORD: the authentication password
• PLANKA_ALLOW_INSECURE: set to true if you are using an internal or self-signed SSL certificate (only in trusted internal environments) Include these in your MCP client configuration to ensure proper connectivity and authentication.

Examples of MCP client configurations

{
  "mcpServers": {
    "planka": {
      "command": "npx",
      "args": ["@grec0/mcp-planka@latest"],
      "env": {
        "PLANKA_BASE_URL": "http://localhost:3000",
        "PLANKA_AGENT_EMAIL": "demo@demo.demo",
        "PLANKA_AGENT_PASSWORD": "demo"
      }
    }
  }
}

If you are connecting to a remote Planka server, you can point to the remote URL and credentials in the same way.

Security and troubleshooting notes

Use secure connections whenever possible. If you encounter SSL certificate issues with self-signed certificates, enable insecure connections only in trusted internal environments by setting PLANKA_ALLOW_INSECURE to true. Verify that PLANKA_BASE_URL, PLANKA_AGENT_EMAIL, and PLANKA_AGENT_PASSWORD are correctly configured.

Tools and endpoints you can use

The MCP Planka server exposes a set of tools to manage your Kanban workflow from MCP clients. These tools handle projects, boards, lists, cards, labels, tasks, comments, memberships, and time tracking.

Notes on installation and start flows (STDIO and HTTP)

STDIO configurations (local) use a command that runs the MCP planka server directly in your environment. A typical setup runs an npm script or a Node.js process that starts the server locally.

Troubleshooting quick starts

If you need to verify connectivity, try a basic connectivity check against your Planka API using your environment’s standard HTTP request tool, confirming that the server is reachable and accepting tokens.

Available tools

Create and manage projects and boards

CRUD operations for projects and boards to organize workspaces and timelines.

Manage lists within boards

Create, update, and organize lists inside Kanban boards.

Card lifecycle management

Create, move, duplicate, and organize Kanban cards across lists.

Stopwatch for time tracking

Start and stop timers to track time spent on cards.

Labels and categorization

Create and apply color-coded labels to organize cards.

Card comments

Add and view comments to facilitate collaboration on cards.

Task management

Create subtasks, track progress, and mark completion.

Membership and access control

Manage board access and permissions for users.