# Plane Workflow

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 repo stars
- Author: amirhosseinkz
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/amirhosseinkz/plane-workflow-mcp/tree/HEAD/plugins/plane-workflow
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/plane-workflow

## What it 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.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
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>

### Codex

**Platform CLI**
```bash
codex mcp add plane-workflow -- 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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add plane-workflow 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>

## When to use it
- 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
- 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.

## Similar
- [Offer Letter Generator](https://affpapa.org/en/nevibecode/skills/offer-letter-generator.md) — skill · 4700 installs
- [exam-ingest](https://affpapa.org/en/nevibecode/skills/exam-ingest.md) — skill · ★ 399 repo stars
- [cowork-contract-renewal-radar](https://affpapa.org/en/nevibecode/skills/cowork-contract-renewal-radar.md) — skill · 105 installs
- [firecrawl-parse](https://affpapa.org/en/nevibecode/skills/firecrawl-parse.md) — skill · 51700 installs
- [k2f](https://affpapa.org/en/nevibecode/skills/k2f.md) — skill · 7500 installs
- [liteparse](https://affpapa.org/en/nevibecode/skills/liteparse.md) — skill · 4200 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
