gogogadgetbytes/planka-mcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

12 stars 14 forks 质量 70 趋势 19MIT

Repository Install

MCP server for PLANKA kanban boards - Claude and AI agent integration

概览

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 Add to ~/Library/Application Support/Claude/claude_desktop_config.json: 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 - PLANKA - The kanban board - MCP SDK - Model Context Protocol - Design Document - Technical design details

README

以下为原文 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": "[email protected]",
        "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": "[email protected]",
        "PLANKA_AGENT_PASSWORD": "your-password"
      }
    }
  }
}

Available Tools

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"

在 GitHub 查看完整 README

安装

npx @gogogadgetbytes/planka-mcp

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "planka": {
      "command": "npx",
      "args": ["@gogogadgetbytes/planka-mcp"],
      "env": {
        "PLANKA_BASE_URL": "https://planka.example.com",
        "PLANKA_AGENT_EMAIL": "[email protected]",
        "PLANKA_AGENT_PASSWORD": "your-password"
      }
    }
  }
}