Planka

io.github.gogogadgetbytes由 GitHub 账号 gogogadgetbytes 发布v1.0.0更新于 Oct 25, 2026

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

已验证STDIO仅桌面效率与工作流开发者工具

概览

AI 生成的概览

一个本地 MCP 服务器，让助手读取和管理 PLANKA 看板：项目、看板、列表、卡片、任务、标签和评论。

可以做什么
浏览项目、看板和列表的层级结构，读取包含卡片、列表和标签的看板，或获取单张卡片及其任务和评论。创建、更新、移动和删除卡片，也可在创建卡片时一并添加清单任务。在卡片上添加、更新和删除任务。创建、更新和删除看板标签，并为卡片添加或移除标签。为卡片添加评论并读取卡片上的全部评论。创建、更新和删除列表。
适用场景
当团队使用 PLANKA 2.0 进行看板管理，并希望助手在不切换到网页界面的情况下查看看板状态、起草或提交卡片、在列表间移动卡片、勾选任务或发表评论时使用。
运行要求
通过 npm 包以 npx 在本地运行，需要 Node.js。需要可访问的 PLANKA 2.0 服务器地址（PLANKA_BASE_URL），以及专用代理账号的邮箱和密码（PLANKA_AGENT_EMAIL、PLANKA_AGENT_PASSWORD）。需要能访问该服务器的网络。
安装前请注意
服务器会把 PLANKA 账号密码以 PLANKA_AGENT_PASSWORD 形式保存在客户端配置文件中，建议使用权限受限的专用代理账号而非个人账号。多数工具会写入、移动或删除看板数据（卡片、任务、标签、列表、评论），删除操作可能难以撤销。所有看板内容都会发送到所配置的 PLANKA 服务器。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Planka，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

bash
npm install @gogogadgetbytes/planka-mcp

Or run directly:

bash
npx @gogogadgetbytes/planka-mcp

Configuration

Environment Variables

VariableRequiredDescription
PLANKA_BASE_URLYesYour PLANKA server URL
PLANKA_AGENT_EMAILYesAgent user email
PLANKA_AGENT_PASSWORDYesAgent user password

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

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:

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

Navigation

ToolDescription
planka_get_structureGet projects, boards, and lists hierarchy
planka_get_boardGet a board with all cards, lists, and labels

Cards

ToolDescription
planka_create_cardCreate a card (optionally with tasks)
planka_update_cardUpdate card properties
planka_move_cardMove card to different list/position
planka_get_cardGet card details with tasks/comments
planka_delete_cardDelete a card

Tasks

ToolDescription
planka_create_tasksAdd tasks (checklist items) to a card
planka_update_taskUpdate task name or completion
planka_delete_taskDelete a task

Labels

ToolDescription
planka_manage_labelsCreate/update/delete board labels
planka_set_card_labelsAdd/remove labels from a card

Comments

ToolDescription
planka_add_commentAdd a comment to a card
planka_get_commentsGet all comments on a card

Lists

ToolDescription
planka_manage_listsCreate/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

bash
# Clonegit clone https://github.com/gogogadgetbytes/planka-mcp.gitcd planka-mcp
# Installnpm install
# Buildnpm run build
# Testnpm test

License

MIT

Links

来源：README.md，提交 a42823a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分