Odel
MCP server: One MCP server.

PLANKA

@gogogadgetbytesMCP server · External

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

Task managementv1.0.0MITTypeScript
Freeno charge per call
How to install

Runs on your machine from its package; the steps are below.

What it does

  1. Reads
  2. Writes
  3. High impact

At most: creates or changes data: records, files, settings.

What it costs

Free

Odel charges nothing per call. The publisher may charge for its own service.

Runs locally over stdio

This server isn't hosted — your MCP client launches it from a package registry. Use one of the commands below, or drop the config into your client (e.g. Claude Desktop).

npm@gogogadgetbytes/planka-mcpv1.0.0

Run

npx -y @gogogadgetbytes/planka-mcp

MCP client config

{
  "mcpServers": {
    "planka": {
      "command": "npx",
      "args": [
        "-y",
        "@gogogadgetbytes/planka-mcp"
      ]
    }
  }
}
README2 min read

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": "agent@example.com",
        "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": "agent@example.com",
        "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
# Clone
git clone https://github.com/gogogadgetbytes/planka-mcp.git
cd planka-mcp

# Install
npm install

# Build
npm run build

# Test
npm test

License

MIT

Links

Similar modules

Browse Task management