English Français العربية

io.github.gogogadgetbytes/planka

Registre officiel Autres

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

Code source Documentation

Que pouvez-vous faire avec 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

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « 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
Configuration 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>"
            }
        }
    }
}

Variables d'environnement

  • PLANKA_BASE_URL obligatoire PLANKA server URL (e.g., https://planka.example.com)
  • PLANKA_AGENT_EMAIL obligatoire Email/username for PLANKA authentication
  • PLANKA_AGENT_PASSWORD obligatoire secret Password for PLANKA authentication

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que io.github.gogogadgetbytes/planka ?

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

Comment installer io.github.gogogadgetbytes/planka ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.gogogadgetbytes/planka ?

Oui. Il attend PLANKA_BASE_URL, PLANKA_AGENT_EMAIL, PLANKA_AGENT_PASSWORD, à renseigner dans sa configuration.

io.github.gogogadgetbytes/planka est-il open source ?

Oui. Son code est sur GitHub sous licence MIT.

Qui maintient io.github.gogogadgetbytes/planka ?

Il est publié par gogogadgetbytes. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.