planka

PLANKA MCP サーバー

PLANKA のカンバンボード向け Model Context Protocol（MCP）サーバーです。Claude などの AI エージェント向けに専用設計されています。

機能

• PLANKA 2.0 API を全面的にサポート
• Zod による検証で型安全
• エージェントのワークフローに最適化（複数操作の組み合わせ、適切なデフォルト値）
• カード、タスク、ラベル、コメント、リストを操作する 13 個のツール

インストール

npm install @gogogadgetbytes/planka-mcp

または、直接実行します。

npx @gogogadgetbytes/planka-mcp

設定

環境変数

変数	必須	説明
PLANKA_BASE_URL	はい	PLANKA サーバーの URL
PLANKA_AGENT_EMAIL	はい	エージェントユーザーのメールアドレス
PLANKA_AGENT_PASSWORD	はい	エージェントユーザーのパスワード

Claude Desktop

~/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

~/.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"
      }
    }
  }
}

利用可能なツール

ナビゲーション

ツール	説明
planka_get_structure	プロジェクト、ボード、リストの階層を取得
planka_get_board	すべてのカード、リスト、ラベルを含むボードを取得

カード

ツール	説明
planka_create_card	カードを作成（タスクを追加することもできます）
planka_update_card	カードのプロパティを更新
planka_move_card	カードを別のリストまたは位置に移動
planka_get_card	タスクやコメントを含むカードの詳細を取得
planka_delete_card	カードを削除

タスク

ツール	説明
planka_create_tasks	カードにタスク（チェックリスト項目）を追加
planka_update_task	タスク名または完了状態を更新
planka_delete_task	タスクを削除

ラベル

ツール	説明
planka_manage_labels	ボードのラベルを作成、更新、削除
planka_set_card_labels	カードにラベルを追加、またはカードからラベルを削除

コメント

ツール	説明
planka_add_comment	カードにコメントを追加
planka_get_comments	カードのすべてのコメントを取得

リスト

ツール	説明
planka_manage_lists	リストを作成、更新、削除

使用例

ボード構造を取得

Use planka_get_structure to see all projects and boards

タスク付きのカードを作成

Use planka_create_card with:
- listId: "abc123"
- name: "Implement feature X"
- tasks: ["Research", "Design", "Implement", "Test"]

ワークフローに沿ってカードを移動

Use planka_move_card to move card from "To Do" to "In Progress"

PLANKA 2.0 との互換性

このサーバーは PLANKA 2.0 向けに設計されており、1.x との API の違いに対応しています。

• カードの作成時に必須の type フィールドを含めます
• ラベルのエンドポイントには /card-labels パスを使用します
• オプションのフィールドを適切に処理します

開発

# Clone
git clone https://github.com/gogogadgetbytes/planka-mcp.git
cd planka-mcp

# Install
npm install

# Build
npm run build

# Test
npm test

ライセンス

MIT

リンク

• PLANKA - カンバンボード
• MCP SDK - Model Context Protocol
• 設計ドキュメント - 技術設計の詳細