概要
What is Planka V2?
Planka V2 is an MCP server that connects AI agents (Claude, Cursor, Codex, etc.) directly to Planka v2.x boards. It exposes the Planka v2 API through the Model Context Protocol, giving agents structured, secure access to projects, boards, cards, tasks, comments, labels, and workflows. It is built specifically for Planka v2.x and is not compatible with Planka v1.x.
How to use Planka V2?
Configure your MCP client with the command npx -y @goldpulpy/planka-v2-mcp@latest and set the required environment variables: PLANKA_BASE_URL, PLANKA_AGENT_EMAIL, PLANKA_AGENT_PASSWORD, and optionally PLANKA_IGNORE_SSL. After configuration, verify the connection by asking a read-only query such as "List my Planka projects." Detailed configuration examples are provided for Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Antigravity, Codex CLI, Continue, Zed, and any other MCP-compatible client.
Key features of Planka V2
- Full project and board management
- Complete card lifecycle management
- Task lists and individual tasks support
- Comments, labels, and card assignments
- Card time tracking with stopwatch
- Project and board aggregate summaries
- Self-hosted and cloud Planka support
Use cases of Planka V2
- Create a project with multiple boards using natural language
- Create a card with a checklist of tasks in one step
- Automate workflow: find overdue cards, move them, add comments, and generate a project summary
- Manage board membership and assign card members by ID, email, or username
- Query project summaries or board details via conversational interface
FAQ from Planka V2
Which Planka versions does this MCP support?
It is tested with Planka 2.0.0-rc.2 and 2.1.1. Newer 2.x versions are expected to work. Planka v1.x is not supported.
What environment variables are required?
You must set PLANKA_BASE_URL, PLANKA_AGENT_EMAIL, and PLANKA_AGENT_PASSWORD. Optionally, set PLANKA_IGNORE_SSL to "true" for self-signed certificates in trusted local environments.
Which MCP clients are supported?
The server works with Claude Desktop, Claude Code, Cursor, Windsurf, Cline, Antigravity, Codex CLI, Continue, Zed, and any client that supports the standard stdio command/args/env configuration.
How does authentication work?
The server authenticates against your Planka instance using the agent email and password provided in the environment variables. No additional tokens or API keys are required.
Where does my data live?
All data remains in your Planka instance (self-hosted or cloud). The MCP server only acts as a bridge, communicating via the Planka API. No data is stored or processed externally.
