Skip to main content
Glama
gogogadgetbytes

planka-mcp

by gogogadgetbytes
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

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

Install Server
A
license - permissive license
A
quality
C
maintenance

How are these scores calculated?

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

View all tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/gogogadgetbytes/planka-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server