planka-mcp

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

• 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

npm install @gogogadgetbytes/planka-mcp

Or run directly:

npx @gogogadgetbytes/planka-mcp

| Variable | Required | Description | |----------|----------|-------------| | PLANKA_BASE_URL | Yes | Your PLANKA server URL | | PLANKA_AGENT_EMAIL | Yes | Agent user email | | PLANKA_AGENT_PASSWORD | Yes | Agent user password |

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

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

| Tool | Description | |------|-------------| | planka_get_structure | Get projects, boards, and lists hierarchy | | planka_get_board | Get a board with all cards, lists, and labels |

| Tool | Description | |------|-------------| | planka_create_card | Create a card (optionally with tasks) | | planka_update_card | Update card properties | | planka_move_card | Move card to different list/position |