1. Conduid
  2. Productivity
  3. io.github.gogogadgetbytes/planka
MCP server · Productivity

io.github.gogogadgetbytes/planka

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

Unclaimed productivity
37Low

Scored 6 months ago · breakdown

About io.github.gogogadgetbytes/planka

io.github.gogogadgetbytes/planka is an MCP server in the Productivity category: mCP server for PLANKA kanban boards. Full CRUD for cards, tasks, comments, and labels.

Install

Claude Code
claude mcp add io-github-gogogadgetbytes-planka -- npx -y @gogogadgetbytes/planka-mcp
npx
npx -y @gogogadgetbytes/planka-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (2)

planka_get_boardGet a board with all cards, lists, and labels

Parameters not published.

planka_get_structureGet projects, boards, and lists hierarchy

Parameters not published.

Ask AI

✦

Ask AI about io.github.gogogadgetbytes/planka

Powered by Claude · Grounded in docs

I know everything about io.github.gogogadgetbytes/planka. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

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

Links

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.gogogadgetbytes/planka

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

Run claude mcp add io-github-gogogadgetbytes-planka -- npx -y @gogogadgetbytes/planka-mcp, then add the server to your MCP client's configuration.

Is io.github.gogogadgetbytes/planka safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.gogogadgetbytes/planka still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.