AI agents for Plane

List projects

Lists the workspace's projects the token's user can see.

List work items

Lists a project's work items (issues), newest first unless order_by says otherwise (like -updated_at or priority).

Search work items

Searches work item names across the workspace, or in one project.

Get a work item

Reads one work item by its project and ID: name, description_html, priority, state, assignees, labels.

Get a work item by key

Reads one work item by its readable key, like WEB-123 (the project identifier and the number).

List work item comments

Lists the comments on a work item.

List states

Lists a project's workflow states, to find the state ID that moves a work item to another status.

List labels

Lists a project's labels.

List workspace members

Lists the workspace's members, to find the user IDs used as assignees.

Create a work item

Creates a work item in a project with a name and optionally an HTML description, state (a state ID from "List states"; the project's default otherwise), assignees and labels.

Update a work item

Changes a work item: move it to another state (status), replace its assignees or labels, set priority, start or due date, rename it or change its HTML description.

Comment on a work item

Adds a comment to a work item as the token's user.

Log time on a work item

Records time spent on a work item, in minutes, with an optional note, as the token's user (time tracking must be on for the project; it is a paid Plane feature).