{"_id":"@borgius/mcp-planka","name":"@borgius/mcp-planka","dist-tags":{"latest":"0.0.7"},"versions":{"0.0.7":{"name":"@borgius/mcp-planka","version":"0.0.7","description":"MCP server for Planka kanban board","license":"MIT","author":{"name":"Brad Risse"},"homepage":"https://github.com/bradrisse/mcp-kanban","bugs":{"url":"https://github.com/bradrisse/mcp-kanban/issues"},"type":"module","bin":{"mcp-planka":"dist/index.js"},"scripts":{"build":"tsc && shx chmod +x dist/*.js","watch":"tsc --watch","up":"docker compose --env-file .env up -d","down":"docker compose down","restart":"docker compose --env-file .env restart","build-docker":"npm run build && docker build -t mcp-planka:latest .","start-node":"node dist/index.js","inspector":"SERVER_PORT=3008 CLIENT_PORT=5174 npx -y @modelcontextprotocol/inspector node dist/index.js","inspector:demo":"SERVER_PORT=3008 CLIENT_PORT=5174 npx -y @modelcontextprotocol/inspector -e PLANKA_BASE_URL=http://localhost:3000 -e PLANKA_ADMIN_ID=1460688047300412417 -e PLANKA_AGENT_EMAIL=claude-sic-score-front-end@cursor.com -e PLANKA_AGENT_PASSWORD=supersupersecre1 node dist/index.js","test":"node --experimental-vm-modules node_modules/jest/bin/jest.js --testMatch='**/tests/**/*.test.ts'","prepublishOnly":"npm run build","release":"npm version patch && npm run build && npm publish --access public","release:minor":"npm version minor && npm run build && npm publish --access public","release:major":"npm version major && npm run build && npm publish --access public"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"1.6.1","@types/node":"^22","@types/node-fetch":"^2.6.12","node-fetch":"^3.3.2","universal-user-agent":"^7.0.2","zod":"^3.22.4","zod-to-json-schema":"^3.23.5"},"devDependencies":{"@jest/globals":"^29.7.0","@types/jest":"^29.5.14","jest":"^29.7.0","shx":"^0.3.4","ts-jest":"^29.2.6","typescript":"^5.6.2"},"_id":"@borgius/mcp-planka@0.0.7","gitHead":"3e1b52695c63c43d9b18056f7f610979d4a141b1","_nodeVersion":"22.21.1","_npmVersion":"10.9.4","dist":{"integrity":"sha512-3cECeF1EfUdWGjjlDZ56R9IXEcgPtg5lQvRzy+467K2A+OClgKlFsul6RM+zrXWfEROspZxSXXNLQdnkBEBVMw==","shasum":"f0b5f4b7080efcf37b36fc453aa9a8736ec6e721","tarball":"https://registry.npmjs.org/@borgius/mcp-planka/-/mcp-planka-0.0.7.tgz","fileCount":21,"unpackedSize":142319,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIByp/v7Ex3REDZ99egt5y+lzzSll4cZ4CcdWQsYJLwQfAiEA26sMSEer1Yy584b6sZJGwOETxPPML0GN2lYLIFNeynM="}]},"_npmUser":{"name":"borgius","email":"e3w2q1+yamlx@gmail.com"},"directories":{},"maintainers":[{"name":"borgius","email":"e3w2q1+yamlx@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-planka_0.0.7_1771467538832_0.9563941730036831"},"_hasShrinkwrap":false}},"time":{"created":"2026-02-19T02:18:58.753Z","0.0.7":"2026-02-19T02:18:58.977Z","modified":"2026-02-19T02:18:59.154Z"},"maintainers":[{"name":"borgius","email":"e3w2q1+yamlx@gmail.com"}],"description":"MCP server for Planka kanban board","homepage":"https://github.com/bradrisse/mcp-kanban","author":{"name":"Brad Risse"},"bugs":{"url":"https://github.com/bradrisse/mcp-kanban/issues"},"license":"MIT","readme":"# 🔄 Kanban MCP\n\nWelcome to the Kanban MCP project! 🎉 This project integrates Planka kanban boards with Cursor's Machine Control Protocol (MCP) to enable AI assistants like Claude to manage your kanban boards.\n\n## 🤔 What is Kanban MCP?\n\nKanban MCP is a bridge between [Planka](https://planka.app/) (an open-source kanban board) and [Cursor](https://cursor.sh/)'s Machine Control Protocol. It allows AI assistants like Claude to:\n\n- 📋 View and manage projects, boards, lists, and cards\n- ✅ Create and update tasks\n- 💬 Add comments to cards\n- 🔄 Move cards between lists\n- ⏱️ Track time spent on tasks\n- 🚀 And much more!\n\nThis integration enables a seamless workflow where you can ask Claude to help manage your development tasks, track progress, and organize your work.\n\n## 🚦 Quick Start\n\n### 📋 Prerequisites\n\n- 🟢 [Node.js](https://nodejs.org/) (version 18 or above)\n- 🐳 [Docker](https://www.docker.com/get-started) for running Planka (or an existing Planka instance)\n\n### 🚀 Usage with npx (recommended)\n\nNo installation required — just configure your MCP client to run the server via `npx`:\n\n#### Claude Desktop / Cursor\n\nAdd this to your MCP configuration (`claude_desktop_config.json` or `.cursor/mcp.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"planka\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@borgius/mcp-planka\"],\n      \"env\": {\n        \"PLANKA_BASE_URL\": \"http://localhost:3333\",\n        \"PLANKA_AGENT_EMAIL\": \"demo@demo.demo\",\n        \"PLANKA_AGENT_PASSWORD\": \"demo\"\n      }\n    }\n  }\n}\n```\n\n#### Global install (alternative)\n\n```bash\nnpm install -g @borgius/mcp-planka\nmcp-planka\n```\n\n### 🐳 Running Planka with Docker\n\nIf you don't have a Planka instance yet, clone this repo and start one:\n\n```bash\ngit clone https://github.com/bradrisse/kanban-mcp.git\ncd kanban-mcp\nnpm run up\n```\n\n- Default URL: http://localhost:3333\n- Default credentials: demo@demo.demo / demo\n\nFor Docker-based deployment and other advanced options, see the [Installation Guide](https://github.com/bradrisse/kanban-mcp/wiki/Installation-Guide).\n\n## 📚 Documentation\n\n### For Users\n\n- [🛠️ Installation Guide](https://github.com/bradrisse/kanban-mcp/wiki/Installation-Guide): How to install and configure Kanban MCP\n- [📝 Usage Guide](https://github.com/bradrisse/kanban-mcp/wiki/Usage-Guide): How to use Kanban MCP with Claude\n- [💡 Capabilities and Strategies](https://github.com/bradrisse/kanban-mcp/wiki/Capabilities-and-Strategies): Detailed exploration of MCP server capabilities and LLM interaction strategies\n- [⚠️ Troubleshooting](https://github.com/bradrisse/kanban-mcp/wiki/Troubleshooting): Solutions to common issues\n\n### For Developers\n\n- [👨‍💻 Developer Guide](https://github.com/bradrisse/kanban-mcp/wiki/Developer-Guide): Information for developers who want to contribute to or modify Kanban MCP\n- [📖 API Reference](https://github.com/bradrisse/kanban-mcp/wiki/API-Reference): Detailed documentation of the MCP commands and Planka API integration\n\n## ✨ Features\n\nKanban MCP provides a comprehensive set of features for managing your kanban boards:\n\n### 📂 Project Management\n- Create and view projects\n- Manage project settings and members\n\n### 📊 Board Management\n- Create and view boards within projects\n- Customize board settings\n\n### 📋 List Management\n- Create and organize lists within boards\n- Reorder lists as needed\n\n### 🗂️ Card Management\n- Create, update, and delete cards\n- Move cards between lists\n- Add descriptions, due dates, and labels\n- Duplicate cards to create templates\n\n### ⏱️ Time Tracking\n- Start, stop, and reset stopwatches\n- Track time spent on individual tasks\n- Analyze time usage patterns\n\n### ✅ Task Management\n- Create and manage tasks within cards\n- Mark tasks as complete or incomplete\n\n### 💬 Comment Management\n- Add comments to cards for discussion\n- View comment history\n\n## 🤖 LLM Interaction Strategies\n\nMCP Kanban supports several workflow strategies for LLM-human collaboration:\n\n1. **🤝 LLM-Driven Development with Human Review**: LLMs implement tasks while humans review and provide feedback\n2. **👥 Human-Driven Development with LLM Support**: Humans implement while LLMs provide analysis and recommendations\n3. **🧠 Collaborative Grooming and Planning**: Humans and LLMs work together to plan and organize tasks\n\nFor more details on these strategies, see the [Capabilities and Strategies](https://github.com/bradrisse/kanban-mcp/wiki/Capabilities-and-Strategies) wiki page.\n\n## 📦 Available npm Scripts\n\n- `npm run build`: Build the TypeScript code\n- `npm run build-docker`: Build the TypeScript code and create a Docker image\n- `npm run up`: Start the Planka containers (kanban and postgres)\n- `npm run down`: Stop all containers\n- `npm run restart`: Restart the Planka containers\n- `npm run start-node`: Start the MCP server directly with Node (for testing outside of Cursor)\n- `npm run release`: Bump patch version, build, and publish to npm\n- `npm run release:minor`: Bump minor version, build, and publish to npm\n- `npm run release:major`: Bump major version, build, and publish to npm\n\n## 🤝 Contributing\n\nWe welcome contributions to Kanban MCP! If you'd like to contribute:\n\n1. Check out the [Developer Guide](https://github.com/bradrisse/kanban-mcp/wiki/Developer-Guide) for information on the project structure and development workflow\n2. Look at the [open issues](https://github.com/bradrisse/kanban-mcp/issues) for tasks that need help\n3. Submit a pull request with your changes\n\n## 🆘 Support\n\nIf you need help with Kanban MCP:\n\n1. Check the [Troubleshooting](https://github.com/bradrisse/kanban-mcp/wiki/Troubleshooting) page for solutions to common issues\n2. Search the [GitHub issues](https://github.com/bradrisse/kanban-mcp/issues) to see if your problem has been reported\n3. Open a new issue if you can't find a solution\n\n## 📜 License\n\nKanban MCP is open-source software licensed under the MIT License. See the [LICENSE](https://github.com/bradrisse/kanban-mcp/blob/main/LICENSE) file for details. ","readmeFilename":"README.md","_rev":"1-c87b2c90fd4c8435490d87ed56d65fa1"}