Returns the Plane MCP server name and version.

List all projects in the workspace. Call this first whenever you need a project_id to pass to other tools.

Create a new project.

Retrieve a project by ID.

Update a project by ID.

Delete a project by ID.

Get all members of a project.

List work items (issues) in a project. Supports filtering by priority, state, state_group, assignees, labels, dates, cycle, and module. Use expand=relations,assignees,labels for richer data. Results are paginated — use the cursor from the response to fetch the next page. When linking to a work item, use the format: {PLANE_BASE_URL}/{workspace_slug}/browse/{project_identifier}-{sequence_id}/

Create a new work item (issue) in a project. Requires project_id from list_projects. Use list_states to get state_id, get_workspace_members for assignee UUIDs, and list_labels for label UUIDs. Dates should be YYYY-MM-DD format. Priority is one of: urgent, high, medium, low, none.

Retrieve a single work item by its UUID. Use expand=relations,assignees,labels for full details. If you have a human-readable identifier like DEV-42, use retrieve_work_item_by_identifier instead.

Update an existing work item. Only include fields you want to change — omitted fields are left unchanged. Use list_states for state_id, get_workspace_members for assignee UUIDs, list_labels for label UUIDs.

Delete a work item by its UUID.

Search for work items by text query. Matches against item names, sequence IDs, and project identifiers. Searches the entire workspace unless project_id is given. Results contain summary fields only (name, id, sequence_id, project identifier); use retrieve_work_item for full details. When linking to a work item, use the format: {PLANE_BASE_URL}/{workspace_slug}/browse/{project_identifier}-{sequence_id}/

Retrieve a work item by its human-readable identifier (e.g. "DEV-42"). Provide the project identifier (e.g. "DEV") and the issue sequence number (e.g. 42).

List all states (statuses) in a project. Call this to get state UUIDs needed for creating or filtering work items. States are grouped by: backlog, unstarted, started, completed, cancelled.

Create a new state in a project. The group field determines where it appears in the workflow: backlog, unstarted, started, completed, or cancelled.

Retrieve a state by ID.

Update a state by ID.

Delete a state by ID.

List all labels in a project. Call this to get label UUIDs needed for creating or filtering work items.

Create a new label in a project.

Retrieve a label by ID.

Update a label by ID.

Delete a label by ID.

List all cycles (sprints) in a project. Returns cycle IDs needed for managing cycle work items.

Create a new cycle (sprint) in a project. The owned_by field requires a user UUID — get it from get_workspace_members or get_me. Dates should be YYYY-MM-DD format.

Retrieve a cycle by ID.

Update a cycle by ID.

Delete a cycle by ID.

List all work items in a specific cycle. Requires project_id and cycle_id — call list_cycles first to get the cycle_id.

Add work items to a cycle. Provide an array of work item UUIDs in issue_ids. Get work item IDs from list_work_items and cycle_id from list_cycles.

Remove a work item from a cycle.

Transfer incomplete work items from one cycle to another. The cycle_id is the source cycle; new_cycle_id is the destination.

List all modules in a project. Modules group related work items by feature or theme. Returns module IDs needed for managing module work items.

Create a new module in a project. The lead field requires a user UUID from get_workspace_members. Members is an array of user UUIDs. Dates should be YYYY-MM-DD format.

Retrieve a module by ID.

Update a module by ID.

Delete a module by ID.

List all work items in a module.

Add work items to a module. Provide an array of work item UUIDs in issues. Get work item IDs from list_work_items and module_id from list_modules.

Remove a work item from a module.

List all epics in a project. Epics are large bodies of work that span multiple work items.

Create a new epic in a project.

Retrieve an epic by ID.

Update an epic by ID.

Delete an epic by ID.

List all milestones in a project. Milestones represent key delivery dates or goals. Returns milestone IDs needed for managing milestone work items.

Create a new milestone in a project.

Retrieve a milestone by ID.

Update a milestone by ID.

Delete a milestone by ID.

List all work items in a milestone.

Add work items to a milestone.

Remove work items from a milestone.

List all initiatives in the workspace.

Create a new initiative.

Retrieve an initiative by ID.

Update an initiative by ID.

Delete an initiative by ID.

Create a new page. If project_id is provided, creates a project page; otherwise creates a workspace page.

Retrieve a page by ID. If project_id is provided, retrieves a project page; otherwise retrieves a workspace page.

Get the currently authenticated user. Returns the user profile including their UUID, which can be used as an assignee or cycle owner in other tools.

Get all workspace members with their user IDs. Call this to find assignee IDs before creating or filtering work items by assignee.

List all comments on a work item.

Add a comment to a work item.

Retrieve a single comment by ID.

Update a comment on a work item.

Delete a comment from a work item.

List all links attached to a work item.

Add a link to a work item.

Retrieve a single link by ID.

Update a link on a work item.

Delete a link from a work item.

List all relations for a work item. Relations include: blocked_by, blocks, duplicate, and relates_to.

Create a relation between two work items.

Remove a relation between two work items.

List all activities (history/audit log) for a work item.

Create multiple work items at once with automatic rate limiting and retry on 429. Pass an array of items — each with the same fields as create_work_item. Returns created IDs and any failures. Use this instead of calling create_work_item in a loop for 10+ items.