Skip to main content

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-mcp
plane-workflow setup --client claude-code
plane-workflow project list
plane-workflow project activate PROJECT_ID
plane-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

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

Metadata

Release files for plane-workflow-mcp 0.6.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for plane-workflow-mcp 0.6.1
File Size Uploaded Provenance
plane_workflow_mcp-0.6.1.tar.gz 62.9 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for plane-workflow-mcp 0.6.1
File Interpreter ABI Platform
plane_workflow_mcp-0.6.1-py3-none-any.whl Python 3 none any Details

Total release size: 116.7 kB

Release files / plane_workflow_mcp-0.6.1.tar.gz

Download URL plane_workflow_mcp-0.6.1.tar.gz
Size 62.9 kB
Tags Source
SHA-256 checksum
How to use checksums
57505b8af4f2f298b7b6fb8dd4c1a3d1917e68a9aacecafeda471492c851644d
BLAKE2b-256 checksum
How to use checksums
30836dbdfe44d00f0f393f60b8b31d2a1eaf5551d4e61e0cc257652adae0c385
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / plane_workflow_mcp-0.6.1-py3-none-any.whl

Download URL plane_workflow_mcp-0.6.1-py3-none-any.whl
Size 53.8 kB
Tags Python 3
SHA-256 checksum
How to use checksums
14d1074d32d726f3c7795d9b232aedb3e0a3f12b8b2971194ab42cff6f59b370
BLAKE2b-256 checksum
How to use checksums
ac9591fd35a2def078da4a76a4fa31ed0b9430f618444f559611ede7038f388f
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via uv/0.13.6 {"installer":{"name":"uv","version":"0.13.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for plane-workflow-mcp 0.6.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page