Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add plane-workflow-mcp -- uvx plane-workflow-mcp
Open on GitHub

What 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-mcp

uvx 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.

Similar MCP servers

All MCP servers for Notes, tasks and projects →

Project sponsors

Companies that keep this analytics open