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 分