Plane Workflow

Plane Workflow MCP

Keep Plane tasks in sync with your coding agent using configurable team workflows. Draft structured tasks, preview changes, record completion evidence, and get read-only project briefings or DOCX/PDF reports.

Install and get your first result

Requires Python 3.11+, uv, and a Plane workspace with an API key. Install from PyPI:

uv tool install plane-workflow-mcpplane-workflow setup --client claude-codeplane-workflow project listplane-workflow project activate PROJECT_IDplane-workflow status

Replace PROJECT_ID with a listed ID. Setup also has --client codex, cursor, claude-desktop, opencode, and zed adapters. Restart the client, then ask:

Confirm my active Plane workspace and project, then show overdue and unassigned work. Include identifiers and totals, flag truncated lists, and do not change Plane data.

To use an unreleased checkout, run uv tool install ./plugins/plane-workflow from the repository root instead.

Workflow behavior

• Advisory planning accepts incomplete planning data; strict planning requires scope, complexity, assignment, an estimate mapping, dates, and an unstarted state.
• Project selection guards work-item mutations against conflicting projects.
• Completion requires a started item, a summary, and verification text; the completion record is written before the state transition.
• API keys are stored in the OS keyring by guided setup. Environment variables support headless use.

Preview supported writes with dry_run=true and ask the agent to wait for approval. Some writes default to applying changes. Approval is a client workflow, not a server-enforced human approval gate. Updates happen through tool calls, not a background code-to-task sync.

Documentation

• Quick start and official-server comparison
• Installation and client compatibility
• Copyable workflow examples
• Planning and workflow configuration
• Demo
• Support

MIT licensed. Independent community project; not affiliated with Plane.