{
  "markdown": "# PLANKA MCP Server\n\nA Model Context Protocol (MCP) server for [PLANKA](https://planka.app) kanban boards, purpose-built for Claude and other AI agents.\n\n## Features\n\n- Full PLANKA 2.0 API support\n- Type-safe with Zod validation\n- Optimized for agent workflows (combined operations, sensible defaults)\n- 13 tools covering cards, tasks, labels, comments, and lists\n\n## Installation\n\n```bash\nnpm install @gogogadgetbytes/planka-mcp\n```\n\nOr run directly:\n\n```bash\nnpx @gogogadgetbytes/planka-mcp\n```\n\n## Configuration\n\n### Environment Variables\n\n| Variable | Required | Description |\n|----------|----------|-------------|\n| `PLANKA_BASE_URL` | Yes | Your PLANKA server URL |\n| `PLANKA_AGENT_EMAIL` | Yes | Agent user email |\n| `PLANKA_AGENT_PASSWORD` | Yes | Agent user password |\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"planka\": {\n      \"command\": \"npx\",\n      \"args\": [\"@gogogadgetbytes/planka-mcp\"],\n      \"env\": {\n        \"PLANKA_BASE_URL\": \"https://planka.example.com\",\n        \"PLANKA_AGENT_EMAIL\": \"agent@example.com\",\n        \"PLANKA_AGENT_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n### Claude Code\n\nAdd to `~/.claude.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"planka\": {\n      \"command\": \"npx\",\n      \"args\": [\"@gogogadgetbytes/planka-mcp\"],\n      \"env\": {\n        \"PLANKA_BASE_URL\": \"https://planka.example.com\",\n        \"PLANKA_AGENT_EMAIL\": \"agent@example.com\",\n        \"PLANKA_AGENT_PASSWORD\": \"your-password\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### Navigation\n\n| Tool | Description |\n|------|-------------|\n| `planka_get_structure` | Get projects, boards, and lists hierarchy |\n| `planka_get_board` | Get a board with all cards, lists, and labels |\n\n### Cards\n\n| Tool | Description |\n|------|-------------|\n| `planka_create_card` | Create a card (optionally with tasks) |\n| `planka_update_card` | Update card properties |\n| `planka_move_card` | Move card to different list/position |\n| `planka_get_card` | Get card details with tasks/comments |\n| `planka_delete_card` | Delete a card |\n\n### Tasks\n\n| Tool | Description |\n|------|-------------|\n| `planka_create_tasks` | Add tasks (checklist items) to a card |\n| `planka_update_task` | Update task name or completion |\n| `planka_delete_task` | Delete a task |\n\n### Labels\n\n| Tool | Description |\n|------|-------------|\n| `planka_manage_labels` | Create/update/delete board labels |\n| `planka_set_card_labels` | Add/remove labels from a card |\n\n### Comments\n\n| Tool | Description |\n|------|-------------|\n| `planka_add_comment` | Add a comment to a card |\n| `planka_get_comments` | Get all comments on a card |\n\n### Lists\n\n| Tool | Description |\n|------|-------------|\n| `planka_manage_lists` | Create/update/delete lists |\n\n## Usage Examples\n\n### Get board structure\n\n```\nUse planka_get_structure to see all projects and boards\n```\n\n### Create a card with tasks\n\n```\nUse planka_create_card with:\n- listId: \"abc123\"\n- name: \"Implement feature X\"\n- tasks: [\"Research\", \"Design\", \"Implement\", \"Test\"]\n```\n\n### Move card through workflow\n\n```\nUse planka_move_card to move card from \"To Do\" to \"In Progress\"\n```\n\n## PLANKA 2.0 Compatibility\n\nThis server is designed for PLANKA 2.0 and handles the API differences from 1.x:\n\n- Card creation includes required `type` field\n- Label endpoints use `/card-labels` path\n- Optional fields handled gracefully\n\n## Development\n\n```bash\n# Clone\ngit clone https://github.com/gogogadgetbytes/planka-mcp.git\ncd planka-mcp\n\n# Install\nnpm install\n\n# Build\nnpm run build\n\n# Test\nnpm test\n```\n\n## License\n\nMIT\n\n## Links\n\n- [PLANKA](https://planka.app) - The kanban board\n- [MCP SDK](https://github.com/modelcontextprotocol/sdk) - Model Context Protocol\n- [Design Document](./DESIGN.md) - Technical design details\n",
  "bytes": 3804,
  "sha": "4d296a88f048adbabba890c409b868158436aabbefd6fc36b74dd2dc83bd1df4",
  "repo_slug": "gogogadgetbytes/planka-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_gogogadgetbytes_planka_35c09ed9/readme"
}