Plane.so Plugin

Manage projects, work items (issues), cycles, and modules in Plane - an open-source project tracking tool.

Setup

1. Get Your API Key

1. Go to your Plane workspace settings
2. Navigate to API Tokens
3. Create a new token with the required permissions

2. Configure Environment Variables

Create a .env file in this directory:

# Required
PLANE_API_KEY=your-api-key-here
PLANE_WORKSPACE_SLUG=your-workspace-slug

# Optional (for self-hosted instances)
PLANE_BASE_URL=https://api.plane.so

Your workspace slug is found in your Plane URL: https://app.plane.so/your-workspace-slug

3. Install & Run

pnpm install
pnpm run quickstart

Available Tools

Connection

• plane-test-connection - Test connection and get user/workspace info
• plane-get-current-user - Get current user details
• plane-get-workspace-members - List workspace members

Projects

• plane-get-projects - List all projects
• plane-get-project - Get project details with members
• plane-create-project - Create a new project
• plane-update-project - Update project settings

Work Items (Issues)

• plane-get-work-items - List work items in a project
• plane-get-work-item - Get work item details by ID
• plane-get-work-item-by-identifier - Get by identifier (e.g., PROJ-123)
• plane-create-work-item - Create a new work item
• plane-update-work-item - Update a work item
• plane-delete-work-item - Delete a work item
• plane-search-work-items - Search work items by text

States & Labels

• plane-get-states - Get workflow states for a project
• plane-create-state - Create a new workflow state
• plane-get-labels - Get project labels
• plane-create-label - Create a new label

Cycles (Sprints)

• plane-get-cycles - List cycles in a project
• plane-get-cycle - Get cycle details
• plane-create-cycle - Create a new cycle
• plane-update-cycle - Update cycle settings
• plane-get-cycle-work-items - List work items in a cycle
• plane-add-work-items-to-cycle - Add work items to a cycle
• plane-remove-work-item-from-cycle - Remove work item from cycle

Modules

• plane-get-modules - List modules in a project
• plane-get-module - Get module details
• plane-create-module - Create a new module
• plane-update-module - Update module settings
• plane-get-module-work-items - List work items in a module
• plane-add-work-items-to-module - Add work items to a module
• plane-remove-work-item-from-module - Remove work item from module

Comments

• plane-get-work-item-comments - Get comments on a work item
• plane-add-comment - Add a comment to a work item

Example Queries

"list all projects in Plane"
"create a new issue called 'Fix login bug' in project X"
"show work items in the current sprint"
"add issue PROJ-123 to the Q4 module"
"what's the status of PROJ-456?"

Self-Hosted Plane

For self-hosted Plane instances, set the PLANE_BASE_URL environment variable to your API endpoint:

PLANE_BASE_URL=https://your-plane-api.example.com

Resources

• Plane Website
• Plane GitHub
• Plane Node SDK