Planka MCP

🚀 PLANKA MCP Server

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

🚀 Quick Start

The PLANKA MCP Server is a specialized server for PLANKA kanban boards, tailored for Claude and other AI agents. It offers full support for the PLANKA 2.0 API and provides a series of useful tools for managing cards, tasks, labels, etc.

✨ Features

• Full API Support: Offers complete support for the PLANKA 2.0 API.
• Type Safety: Ensures type safety through Zod validation.
• Optimized Workflow: Optimized for agent workflows with combined operations and sensible defaults.
• Diverse Tools: Provides 13 tools covering cards, tasks, labels, comments, and lists.

📦 Installation

You can install the server using npm:

npm install @gogogadgetbytes/planka-mcp

Or run it directly:

npx @gogogadgetbytes/planka-mcp

📚 Documentation

Configuration

Environment Variables

Claude Desktop

Add the following 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 the following 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

Cards

Tasks

Labels

Comments

Lists

💻 Usage Examples

Basic Usage

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.

🔧 Technical Details

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

This project is licensed under the MIT license.

🔗 Links

• PLANKA - The kanban board
• MCP SDK - Model Context Protocol
• Design Document - Technical design details