English Français العربية

io.github.gogogadgetbytes/planka

Official registry Other

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

Source code Documentation

What can you do with io.github.gogogadgetbytes/planka?

  • 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

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @gogogadgetbytes/planka-mcp
Claude Code 
claude mcp add planka -e 'PLANKA_BASE_URL=<PLANKA_BASE_URL>' -e 'PLANKA_AGENT_EMAIL=<PLANKA_AGENT_EMAIL>' -e 'PLANKA_AGENT_PASSWORD=<your planka_agent_password>' -- npx -y @gogogadgetbytes/planka-mcp@1.0.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "planka": {
            "command": "npx",
            "args": [
                "-y",
                "@gogogadgetbytes/planka-mcp@1.0.0"
            ],
            "env": {
                "PLANKA_BASE_URL": "<PLANKA_BASE_URL>",
                "PLANKA_AGENT_EMAIL": "<PLANKA_AGENT_EMAIL>",
                "PLANKA_AGENT_PASSWORD": "<your planka_agent_password>"
            }
        }
    }
}

Environment variables

  • PLANKA_BASE_URL required PLANKA server URL (e.g., https://planka.example.com)
  • PLANKA_AGENT_EMAIL required Email/username for PLANKA authentication
  • PLANKA_AGENT_PASSWORD required secret Password for PLANKA authentication

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. PLANKA MCP Server
  2. Features
  3. Installation
  4. Configuration
  5. Available Tools
  6. Usage Examples
  7. PLANKA 2.0 Compatibility
  8. Development
  9. License
  10. Links

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

npm install @gogogadgetbytes/planka-mcp

Or run directly:

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:

{
  "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:

{
  "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

# 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

Frequently asked questions

What is io.github.gogogadgetbytes/planka?

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

How do I install io.github.gogogadgetbytes/planka?

It runs on your machine. In Claude Code: claude mcp add planka -e 'PLANKA_BASE_URL=<PLANKA_BASE_URL>' -e 'PLANKA_AGENT_EMAIL=<PLANKA_AGENT_EMAIL>' -e 'PLANKA_AGENT_PASSWORD=<your planka_agent_password>' -- npx -y @gogogadgetbytes/planka-mcp@1.0.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.gogogadgetbytes/planka need an API key?

Yes. It expects PLANKA_BASE_URL, PLANKA_AGENT_EMAIL, PLANKA_AGENT_PASSWORD, which you set in its configuration.

Is io.github.gogogadgetbytes/planka open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.gogogadgetbytes/planka?

It is published by gogogadgetbytes. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.