MCP Server

Stale

MIT

io.github.gogogadgetbytes/planka MCP Server

io.github.gogogadgetbytes/planka

MCP server for PLANKA kanban boards with full CRUD operations on cards, tasks, comments, and labels.

What is the io.github.gogogadgetbytes/planka MCP server?

The PLANKA MCP server is a Model Context Protocol integration for PLANKA kanban boards, enabling Claude and other AI agents to manage projects, boards, cards, tasks, labels, and comments. It provides 13 tools covering the full PLANKA 2.0 API with type-safe operations optimized for agent workflows.

This server connects Claude to your PLANKA kanban instance, allowing you to programmatically create, read, update, and delete cards, tasks, comments, and labels. Use it to automate board management, sync tasks across systems, or let Claude help organize and track work directly in your kanban board.

How to install io.github.gogogadgetbytes/planka

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

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

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "planka": {
      "command": "npx",
      "args": [
        "-y",
        "@gogogadgetbytes/planka-mcp"
      ],
      "env": {
        "PLANKA_BASE_URL": "<YOUR_PLANKA_BASE_URL>",
        "PLANKA_AGENT_EMAIL": "<YOUR_PLANKA_AGENT_EMAIL>",
        "PLANKA_AGENT_PASSWORD": "<YOUR_PLANKA_AGENT_PASSWORD>"
      }
    }
  }
}

Tools & capabilities

Tools this server exposes to the agent.

planka_get_structure — Get projects, boards, and lists hierarchy
planka_get_board — Get a board with all cards, lists, and labels
planka_create_card — Create a card optionally with tasks
planka_update_card — Update card properties
planka_move_card — Move card to different list or position
planka_get_card — Get card details with tasks and comments
planka_delete_card — Delete a card
planka_create_tasks — Add tasks (checklist items) to a card
planka_update_task — Update task name or completion status
planka_delete_task — Delete a task
planka_manage_labels — Create, update, or delete board labels
planka_set_card_labels — Add or remove labels from a card
planka_add_comment — Add a comment to a card
planka_get_comments — Get all comments on a card
planka_manage_lists — Create, update, or delete lists

Use cases

Automate card creation and task management in PLANKA boards from Claude conversations
Move cards through workflow stages (To Do → In Progress → Done) based on AI decisions
Add comments and labels to cards programmatically for tracking and organization
Retrieve board structure and card details to inform Claude's responses and actions
Sync task checklists and project status across PLANKA and other systems

io.github.gogogadgetbytes/planka MCP server FAQ

What is the PLANKA MCP server?

It's an MCP integration that gives Claude full read-write access to PLANKA kanban boards, including cards, tasks, comments, labels, and lists. It supports PLANKA 2.0 with 13 tools optimized for AI agent workflows.

Is this free?

Yes, the server is open-source under the MIT license. You need a PLANKA instance (self-hosted or cloud) to use it.

How do I install it in Claude Desktop?

Install via npm (npm install @gogogadgetbytes/planka-mcp), then add the server config to ~/Library/Application Support/Claude/claude_desktop_config.json with your PLANKA_BASE_URL, PLANKA_AGENT_EMAIL, and PLANKA_AGENT_PASSWORD.

What authentication is required?

You need a PLANKA server URL, agent user email, and password. These are provided as environment variables (PLANKA_BASE_URL, PLANKA_AGENT_EMAIL, PLANKA_AGENT_PASSWORD).

Can I use this with PLANKA 1.x?

No, this server is designed for PLANKA 2.0. It handles API differences from 1.x such as the required 'type' field for cards and updated label endpoints.

What operations can I perform?

Full CRUD on cards, tasks, comments, and labels; move cards between lists; manage board structure; retrieve board hierarchy and card details.

README (reference)

Source of truth, from the repository.

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

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

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

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

Cards

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
`planka_get_card`	Get card details with tasks/comments
`planka_delete_card`	Delete a card

Tasks

Tool	Description
`planka_create_tasks`	Add tasks (checklist items) to a card
`planka_update_task`	Update task name or completion
`planka_delete_task`	Delete a task

Labels

Tool	Description
`planka_manage_labels`	Create/update/delete board labels
`planka_set_card_labels`	Add/remove labels from a card

Comments

Tool	Description
`planka_add_comment`	Add a comment to a card
`planka_get_comments`	Get all comments on a card

Lists

Tool	Description
`planka_manage_lists`	Create/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

Related MCP servers

io.github.gogogadgetbytes/smart-connections

Stale

MCP server for Obsidian Smart Connections. Semantic search using your vault's embeddings.

TypeScript

MIT

View repository →

TraceWeave

Active

MCP server for RTL/SoC debugging: connect simulation logs, waveforms, and source code to AI assistants.

116

Python

MIT

View repository →

Inday - Public Holiday API

Public holiday data for 30+ countries. Check holidays, working days and calendars via AI assistants.

CordFind Generator Compatibility

Active

Search generator guides, check connector compatibility, and plan generator cord size.

JavaScript

MIT

View repository →

Deckaura Tarot

Maintained

Explore 78 tarot cards with meanings, card draws, spreads, and Deckaura guide links.

TypeScript

MIT

View repository →

io.github.goklab/guardvibe

Active

Deterministic security layer your AI can't be. 525 rules, 39 tools, CLI + doctor + host audit.

TypeScript

Apache-2.0

View repository →

io.github.gogogadgetbytes/planka MCP Server

What is the io.github.gogogadgetbytes/planka MCP server?

How to install io.github.gogogadgetbytes/planka

Tools & capabilities

Use cases

io.github.gogogadgetbytes/planka MCP server FAQ

PLANKA MCP Server

Features

Installation

Configuration

Environment Variables

Claude Desktop

Claude Code

Available Tools

Navigation

Cards

Tasks

Labels

Comments

Lists

Usage Examples

Get board structure

Create a card with tasks

Move card through workflow

PLANKA 2.0 Compatibility

Development

License

Links

Related MCP servers

io.github.gogogadgetbytes/smart-connections

TraceWeave

Inday - Public Holiday API

CordFind Generator Compatibility

Deckaura Tarot

io.github.goklab/guardvibe