Plane

Project management for humans and AI agents. Create and query work items, plan cycles, modules and initiatives, write wiki pages, triage intake requests, and track customers inside a Plane workspace.

Skills

• Search work items
  Find work items across a workspace by free-text query or a Plane Query Language (PQL) filter, without knowing project ids up front.
  work-itemssearchread-only
• List work items in a project
  Page through the work items in one project, optionally filtered with PQL and narrowed to a sparse field set.
  work-itemsread-only
• Find a work item by its readable identifier
  Retrieve a work item from the identifier people actually use, such as ENG-42, without first resolving a UUID. This is the only work item action that accepts a readable identifier — every other action takes the work item's UUID.
  work-itemsread-onlyprerequisite
• Create a work item
  Open a new work item in a project with a name, description, priority, state, assignees, labels, and dates.
  work-itemswrite
• Update a work item
  Change any subset of a work item — state, priority, dates, description, assignees, labels. Only the fields passed are modified.
  work-itemswrite
• Comment on a work item
  Post, edit, or read comments on a work item so an agent can report progress where the work lives.
  work-itemscollaborationwrite
• Log time against a work item
  Record a work log with a duration in minutes, and read back the logs on a work item.
  time-trackingwrite
• List projects
  Enumerate the projects in a workspace with their ids, identifiers, and enabled features.
  projectsread-only
• Create a project
  Set up a project with a name, short identifier, lead, timezone, and the feature modules it should use.
  projectswrite
• Plan a cycle
  Create a time-boxed cycle, list what is in it, and move work items in or out — the sprint-planning loop.
  planningcycleswrite
• Plan a module
  Group related work into a module with a lead, members, dates, and a delivery status.
  planningmoduleswrite
• Track an initiative
  Create and update workspace initiatives, and attach the projects and epics that roll up into them.
  planninginitiativeswrite
• Read and write wiki pages
  List and create pages at workspace (wiki) or project scope, so an agent can file specs and notes next to the work.
  knowledgepageswrite
• Triage the intake queue
  Read the intake queue for a project and accept, reject, or convert submitted requests into work items.
  intaketriagewrite
• Manage customers and requests
  Create customer records, log their requests, and link the work items that deliver against them.
  customerswrite
• Resolve workspace members
  Look up workspace and project members and their roles, so names in a prompt can be turned into the ids other capabilities require.
  membersread-onlyprerequisite
• Identify the current user
  Resolve who the credential authenticates as, including whether it is a bot. Call this to attribute work and to interpret `@me` in a PQL filter.
  membersread-onlyprerequisite
• Retrieve the query language reference
  Fetch the Plane Query Language syntax reference — operators, functions, fields, and worked examples. Call this before composing a `pql` filter for any capability that accepts one.
  queryread-onlyprerequisite
• List workflow states
  Read a project's workflow states and their groups. Call this to turn a state name such as "In Progress" into the id that creating and updating work items requires.
  workspacestatesread-onlyprerequisite
• List labels
  Read a project's labels. Call this to turn label names into the ids that creating and updating work items requires.
  workspacelabelsread-onlyprerequisite
• Read a work item's history
  Page through the change history of a work item — state moves, reassignments, field edits — to summarise what happened and when.
  work-itemsauditread-only
• Relate work items
  Create a typed relation between two work items — blocking, blocked by, duplicate, relates to, or a custom workspace relation type — so dependencies are explicit.
  work-itemsdependencieswrite
• Attach an external link to a work item
  Add a titled external URL to a work item — a pull request, a dashboard, a design file — and read back the links already on it.
  work-itemslinkswrite
• Attach a file to a work item
  Upload a file to a work item. Request presigned upload credentials, POST the file to the returned URL, then confirm the upload. Over MCP the `upload_from_url` action does all three in one call.
  work-itemsattachmentswrite
• Manage work item types
  List and create the work item types in a project — Bug, Story, Epic and any custom type — each with its own icon and custom properties. Prefer the MCP `resolve` action over `create`: it finds an existing type or creates one without duplicating, which is also the only way to get a usable type in a workspace that centrally governs its type vocabulary and refuses project-scoped writes. `import_to_project` links existing workspace types to a project.
  work-itemsconfigurationwriteprerequisite
• Read and write custom property values
  Set or read the value of a work item's custom properties, so an agent can populate the fields a team actually tracks rather than only the built-in ones.
  work-itemscustom-fieldswrite
• Manage estimates
  Create a project's estimation system and read its points, so the `estimate_point` id required when sizing a work item can be resolved.
  planningestimateswriteprerequisite
• Manage epics
  Create epics and attach the work items that roll up into them. Plane models an epic as a work item whose type is named Epic, so over MCP there is no epic tool: resolve the Epic type with `workitem_type resolve`, pass the returned id as `type_id` to `workitem create`, then list epics with `pql='type = "<type id>"'` and an epic's children with `pql='childOf("ENG-12")'`. REST has dedicated epic paths that do this for you.
  planningepicswrite
• Plan a milestone
  Create dated checkpoints in a project and attach the work items that must land by each one.
  planningmilestoneswrite
• Fill and close out a cycle
  Add work items to a cycle, list what is in it, transfer unfinished work to the next cycle, and complete or archive it — the rest of the sprint loop beyond creating the cycle.
  planningcycleswrite
• Fill a module
  Add work items to a module and list what it already contains.
  planningmoduleswrite
• Submit and resolve an intake request
  File a request into a project intake queue, then accept, reject, snooze, or mark it duplicate. Pairs with reading the queue.
  intaketriagewrite
• Log customer requests
  Record what a customer asked for and link the work items that deliver it, so commitments are traceable back to the account.
  customerswrite
• List teamspaces
  Read the teamspaces in a workspace with their members and projects, to scope work to the right team.
  workspaceteamspacesread-only
• Manage releases and changelogs
  Create releases, attach the work items shipping in them, manage release tags and labels, and generate or edit the changelog.
  releaseswrite
• Report progress as a Plane agent
  For agents installed as Plane apps: post thoughts, actions, responses, elicitations, and errors into the Agent Run created when a user @mentions the agent on a work item. Thoughts and actions are ephemeral; a response becomes a visible comment.
  agentscollaborationwrite
• Count and group work items
  Aggregate work item counts across a workspace or project, grouped and sub-grouped by state, priority, assignee, label, type, cycle, module, milestone, release, creator, or date. This is the reporting primitive: Plane's Dashboards and Analytics views themselves have no public API, so an agent answers "how many, broken down by what" with this.
  work-itemsreportingread-only
• Summarise logged time
  Total the time logged against every work item in a project, for timesheet and capacity reporting. Pairs with logging time on an individual work item.
  time-trackingreportingread-only
• Read and toggle project features
  Read or change which feature modules a project has enabled — epics, modules, cycles, views, pages, intake, work item types. Check this before calling a capability that depends on a module being on.
  projectsconfigurationwriteprerequisite
• Read and toggle workspace features
  Read or change which workspace-level features are enabled — initiatives, teamspaces, customers, wiki, project grouping, and Plane AI.
  workspaceconfigurationwriteprerequisite
• Map identity provider groups to roles
  List and create mappings from identity provider groups to Plane roles, at workspace or project scope. This is the one integration-shaped API Plane exposes — the native integrations (GitHub, GitLab, Slack, Sentry, Bitbucket) are configured in workspace settings and have no public endpoints.
  workspaceidentityintegrationwrite

How to call

https://mcp.plane.so/http/mcp

Listed in

Directories this entry was found in.