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 the published GitHub release without cloning:

uv tool install https://github.com/amirhosseinkz/plane-workflow-mcp/releases/download/v0.6.0/plane_workflow_mcp-0.6.0-py3-none-any.whl
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.

The release command installs v0.6.0. To use an unreleased checkout, run uv tool install ./plugins/plane-workflow from the repository root instead. No PyPI release is advertised yet.

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

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.0
File Size Uploaded Provenance
plane_workflow_mcp-0.6.0.tar.gz 63.1 kB Without provenance Details

Built distribution (wheel)

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

Total release size: 117.1 kB

Release files / plane_workflow_mcp-0.6.0.tar.gz

Download URL plane_workflow_mcp-0.6.0.tar.gz
Size 63.1 kB
Tags Source
SHA-256 checksum
How to use checksums
39f0fe11a40bf5d53746fdc38e45d66f6e8eb8f26337916fda5a0544c732c430
BLAKE2b-256 checksum
How to use checksums
58960fcb414fd1922d2d13c98a04dec28a081b5dfa65979d7ac7a6eecce6909f
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.0-py3-none-any.whl

Download URL plane_workflow_mcp-0.6.0-py3-none-any.whl
Size 54.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6806f45fecb4fe2e0036da9feb671533b36d1972ffd4585c527236603f54efbc
BLAKE2b-256 checksum
How to use checksums
1f19a117eb03132d667cc254d9ea7a074b20abf33c962f2852d2c776e329a1c1
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.0

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