Plane Workflow — Claude Code MCP server for Plane tasks
Plane Workflow lets a coding agent plan and update Plane work items under team rules. Use it to review proposed changes, record completion, or get project briefings.
MIT ★ 6 updated 2026-10-29
claude mcp add plane-workflow-mcp -- uvx plane-workflow-mcpWhat Plane Workflow does
Plane Workflow connects a coding agent to a Plane workspace. It can draft structured work items, preview proposed writes, and attach evidence when work is complete. Planning can use an advisory mode or a strict mode that requires planning fields and an item that has not been started.
The server also provides read-only project briefings and DOCX or PDF reports. Project selection guards mutations against the wrong project. Completing an item requires that work has started, along with a summary and verification text. Some writes apply by default; approval is handled by the client, since the server does not enforce a human approval gate.
You need Python 3.11+, uv, a Plane workspace, and an API key. Guided setup can save the key in the OS keyring, while environment variables support headless use. Updates happen through tool calls, not background synchronization between code and tasks.
What it helps with
- draft a structured Plane work item from a plan
- review proposed changes before writing them to Plane
- attach completion evidence to a started item
- get a project briefing or a DOCX/PDF report
Example prompts for the agent
- Check my active Plane workspace and show overdue work without changing anything.
- Draft a Plane work item from this plan and show the proposed changes first.
- Complete this started Plane item with a summary and verification text.
How to install Plane Workflow
Platform CLI
claude mcp add plane-workflow-mcp -- uvx plane-workflow-mcpuvx runs the command named after the package; if the README names another one, use uvx --from plane-workflow-mcp <command>
Platform CLI
codex mcp add plane-workflow -- uvx plane-workflow-mcpuvx runs the command named after the package; if the README names another one, use uvx --from plane-workflow-mcp <command>
Config file
{
"mcpServers": {
"plane-workflow": {
"command": "uvx",
"args": [
"plane-workflow-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from plane-workflow-mcp <command>
Config file
{
"servers": {
"plane-workflow": {
"type": "stdio",
"command": "uvx",
"args": [
"plane-workflow-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from plane-workflow-mcp <command>
Platform CLI
gemini mcp add plane-workflow uvx plane-workflow-mcpuvx runs the command named after the package; if the README names another one, use uvx --from plane-workflow-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Plane Workflow
How do I install Plane Workflow in Claude Code?
Run claude mcp add plane-workflow-mcp -- uvx plane-workflow-mcp. You also need Python 3.11+, uv, a Plane workspace, and an API key.
What does Plane Workflow do?
It lets an agent plan Plane work items, preview proposed writes, record completion evidence, and retrieve project briefings or DOCX/PDF reports.
Does the server require human approval before writing to Plane?
No. A client can use previews and request approval, but the server itself does not hold writes until a person approves them.