English Français العربية

io.github.gogogadgetbytes/planka

السجل الرسمي أخرى

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

الشيفرة المصدرية التوثيق

ماذا يمكنك أن تفعل مع io.github.gogogadgetbytes/planka؟

  • 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

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

NPM package @gogogadgetbytes/planka-mcp
Claude Code 
claude mcp add planka -e 'PLANKA_BASE_URL=<PLANKA_BASE_URL>' -e 'PLANKA_AGENT_EMAIL=<PLANKA_AGENT_EMAIL>' -e 'PLANKA_AGENT_PASSWORD=<your planka_agent_password>' -- npx -y @gogogadgetbytes/planka-mcp@1.0.0
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "planka": {
            "command": "npx",
            "args": [
                "-y",
                "@gogogadgetbytes/planka-mcp@1.0.0"
            ],
            "env": {
                "PLANKA_BASE_URL": "<PLANKA_BASE_URL>",
                "PLANKA_AGENT_EMAIL": "<PLANKA_AGENT_EMAIL>",
                "PLANKA_AGENT_PASSWORD": "<your planka_agent_password>"
            }
        }
    }
}

متغيرات البيئة

  • PLANKA_BASE_URL إلزامي PLANKA server URL (e.g., https://planka.example.com)
  • PLANKA_AGENT_EMAIL إلزامي Email/username for PLANKA authentication
  • PLANKA_AGENT_PASSWORD إلزامي سري Password for PLANKA authentication

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. PLANKA MCP Server
  2. Features
  3. Installation
  4. Configuration
  5. Available Tools
  6. Usage Examples
  7. PLANKA 2.0 Compatibility
  8. Development
  9. License
  10. Links

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
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:

{
  "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
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

# 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

الأسئلة الشائعة

ما هو io.github.gogogadgetbytes/planka؟

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

كيف أثبّت io.github.gogogadgetbytes/planka؟

يعمل على جهازك. في Claude Code: claude mcp add planka -e 'PLANKA_BASE_URL=<PLANKA_BASE_URL>' -e 'PLANKA_AGENT_EMAIL=<PLANKA_AGENT_EMAIL>' -e 'PLANKA_AGENT_PASSWORD=<your planka_agent_password>' -- npx -y @gogogadgetbytes/planka-mcp@1.0.0. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.gogogadgetbytes/planka إلى مفتاح API؟

نعم. يتطلب PLANKA_BASE_URL, PLANKA_AGENT_EMAIL, PLANKA_AGENT_PASSWORD، وتضبطها في إعداداته.

هل io.github.gogogadgetbytes/planka مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون io.github.gogogadgetbytes/planka؟

ينشره gogogadgetbytes. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.