# Plane MCP

> Plane MCP connects your AI agent directly to your Plane workspace. Pull project architectures, audit sprint cycles, and analyze active issues without manually clicking through kanban boards. It gives you instant access to structured data—from projects and modules to tickets—so you can keep building faster.

## Overview
- **Category:** productivity
- **Price:** Free
- **Tags:** agile, issue-tracking, kanban, sprint-management, open-source, software-engineering

## Description

This MCP lets your AI client talk straight to your engineering backlog. Instead of opening Plane in a browser, navigating deep into different project boards just to find the status of one feature, your agent pulls that information directly. You can ask it to review all active sprints and instantly get structured timelines, or pull an isolated view of a specific module's required components. It’s like having your entire workspace data stream right into your chat window. When you connect this through Vinkius, any MCP-compatible client gets the same deep access, letting you analyze everything—from high-level project goals to granular ticket details—in one place.

## Tools

### list_projects
Lists every project available in your Plane workspace.

### get_project
Retrieves all specific details for a single designated project.

### list_work_items
Lists individual tasks and tickets inside a specified project's boundaries.

### list_cycles
Retrieves all active development cycles, or sprints, for a given project.

### list_modules
Lists the major architectural modules (epics) tied to a specific project.

### list_labels
Reads all categorization labels used across your entire Plane project setup.

## Prompt Examples

**Prompt:** 
```
List all cross-functional modules targeting project `project-x`.
```

**Response:** 
```
Pinging standard workspace schemas... I matched Project 'Frontend Rewrite'. There are 4 distinct modules attached: `Auth Module`, `Kanban Redesign`, `API Rate Limiter`, and `User Onboarding`. Looking at `Auth Module`, it is targeting completion by October 20th. Do you need its related tags?
```

**Prompt:** 
```
Are there any pending work items left in the current active active sprint?
```

**Response:** 
```
Looking at cycle `v1.2 Release`, I've pulled 4 unresolved work items out of the 15 originally mapped. Ticket `ID: 9912` (Database Race Condition) is holding up priority, currently marked 'In Progress' by the QA tag. Want me to investigate its raw configuration?
```

**Prompt:** 
```
Fetch the exact details of the issue designated ID `3841-A` on the board.
```

**Response:** 
```
Extracted the data entity mapped to `3841-A`. Title: `Handle missing env parameters explicitly during build steps`. It carries the labels 'High Priority' and 'DevOps'. The raw issue content requests adding an abort sequence checking for missing variables natively during CI initialization. How would you like me to script this?
```

## Capabilities

### List all available projects
Your agent can retrieve a list of every project within your Plane workspace.

### Get detailed project information
You fetch specific, deep details on any single project by its identifier.

### Analyze active work items and issues
The agent performs sweeps over all tasks and tickets inside a specified project's boundary.

### Structure development sprints
You command the system to list and organize your current development cycles or sprints.

### Map out core modules and labels
The agent reads the key architectural modules (epics) and categorization labels used across projects.

## Use Cases

### The End-of-Sprint Status Audit
A PM needs a final progress report. Instead of manually pulling data from multiple boards, they ask their agent to list all active cycles and then use list_work_items on the current cycle. The AI compiles the results, immediately flagging which tickets are stuck or nearing completion.

### Verifying Architecture Compliance
A Product Owner needs to know if a new feature touches old code. They ask their agent to list_modules for the core product and then use list_labels to see which existing components share those modules, ensuring no critical dependencies are missed.

### Debugging Development Roadblocks
A Lead Engineer is stuck on a bug. They ask their agent to get_project details for the affected area and then list_work_items to pull every related ticket, instantly seeing all required changes and dependencies in one chat window.

### Comparing Project Health
The PM needs to compare three competing product lines. They ask their agent to list_projects for the three names and then use get_project on each, generating a side-by-side summary of status parameters and ownership.

## Benefits

- Instantly summarize progress by using list_cycles & list_work_items to gather all pending tasks in the current cycle, saving hours of manual dashboard review.
- Get a complete picture of your development scope. You can use list_modules and list_labels to cross-reference core architectural modules against required categorization labels for compliance checks.
- Deep dive into technical debt or blockers using list_work_items. Your agent sweeps over every ticket in a project, letting you analyze exactly what the engineering team is building right now.
- Quickly scope out any new initiative by calling list_projects and get core details on multiple projects at once, allowing for rapid comparison of status parameters.
- Stay organized with your development timeline. Use list_cycles to pull structured data about active sprints, checking timelines and completion statuses without clicking through the visual kanban board.

## How It Works

The bottom line is you get a direct data pipe into your project's status without logging into the application itself.

1. Install this integration onto your preferred AI client layer.
2. Provide your Plane Personal API Key, plus optionally your self-hosted API URL for secure access.
3. Your agent starts fetching sprints and active cycles immediately from any MCP client.

## Frequently Asked Questions

**How does Plane MCP help me track issues?**
You use list_work_items to perform deep sweeps over tasks and tickets within a project. This pulls all the current issue details, allowing your agent to analyze which items are blocked or overdue.

**Can Plane MCP show me all my projects?**
Yes. Calling list_projects gives you an inventory of every workspace in your Plane account. You can then use get_project on specific IDs to pull detailed status reports for each one.

**I need project modules; what tool do I use?**
Use list_modules. This function specifically reads the architectural epics attached to your projects, helping you understand the high-level components being developed.

**Does Plane MCP handle sprints and cycles?**
Yes, use list_cycles. You can ask the agent for all active development cycles in a project, letting it evaluate timelines and completion statuses automatically.

**What is the difference between listing work items and modules with Plane MCP?**
list_modules shows major architectural components (the 'what'), while list_work_items tracks the granular tasks and tickets needed to complete those components (the 'how').