Can I use Plane as a CLI?

Yes. KosmoKrator exposes a Plane CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Plane through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Plane tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Plane credentials stored?

Plane credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Plane MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Plane CLI for AI Agents

Use the Plane CLI from KosmoKrator to call Plane tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

33 functions 19 read 14 write API key auth

Submit Plane feedback View package source

Plane CLI Setup

Plane can be configured headlessly with `kosmokrator integrations:configure plane`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure plane --set api_key="$PLANE_API_KEY" --enable --read allow --write ask --json
kosmokrator integrations:doctor plane --json
kosmokrator integrations:status --json

Credentials

Authentication type: API key api_key. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

Key	Env var	Type	Required	Label
`api_key`	`PLANE_API_KEY`	Secret `secret`	yes	API Key
`url`	`PLANE_URL`	URL `url`	no	API Base URL
`workspace_slug`	`PLANE_WORKSPACE_SLUG`	Text `string`	no	Default Workspace Slug

Call Plane Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call plane.plane_list_workspaces '{}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:plane plane_list_workspaces '{}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs plane --json
kosmo integrations:docs plane.plane_list_workspaces --json
kosmo integrations:schema plane.plane_list_workspaces --json
kosmo integrations:search "Plane" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Plane.

`plane.plane_list_workspaces`

Read read

List all Plane.so workspaces the authenticated user belongs to. Returns workspace slug, name, and owner info. Use the slug to reference workspaces in other tools.

Parameters: none

Generic CLI call

kosmo integrations:call plane.plane_list_workspaces '{}' --json

Provider shortcut

kosmo integrations:plane plane_list_workspaces '{}' --json

`plane.plane_list_projects`

Read read

List all projects in a Plane.so workspace. Returns project ID, name, identifier, description, and status. Use the project ID to reference projects in other tools.

Parameters: workspace_slug

Generic CLI call

kosmo integrations:call plane.plane_list_projects '{"workspace_slug":"example_workspace_slug"}' --json

Provider shortcut

kosmo integrations:plane plane_list_projects '{"workspace_slug":"example_workspace_slug"}' --json

`plane.plane_get_project`

Read read

Get detailed information about a Plane.so project, including name, identifier, description, status, dates, and settings.

Parameters: workspace_slug, project_id

Generic CLI call

kosmo integrations:call plane.plane_get_project '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

Provider shortcut

kosmo integrations:plane plane_get_project '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

`plane.plane_create_project`

Write write

Create a new project in a Plane.so workspace. Requires a name and identifier (short code, e.g., "PROJ"). Optionally set description, cover image, project lead, and default assignee.

Parameters: workspace_slug, name, identifier, description, cover_image, project_lead, default_assignee

Generic CLI call

kosmo integrations:call plane.plane_create_project '{"workspace_slug":"example_workspace_slug","name":"example_name","identifier":"example_identifier","description":"example_description","cover_image":"example_cover_image","project_lead":"example_project_lead","default_assignee":"example_default_assignee"}' --json

Provider shortcut

kosmo integrations:plane plane_create_project '{"workspace_slug":"example_workspace_slug","name":"example_name","identifier":"example_identifier","description":"example_description","cover_image":"example_cover_image","project_lead":"example_project_lead","default_assignee":"example_default_assignee"}' --json

`plane.plane_archive_project`

Write write

Archive a Plane.so project. Archived projects are hidden from active views but retain all data.

Parameters: workspace_slug, project_id

Generic CLI call

kosmo integrations:call plane.plane_archive_project '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

Provider shortcut

kosmo integrations:plane plane_archive_project '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

`plane.plane_list_issues`

Read read

List issues in a Plane.so project. Supports filtering by state, priority, assignee, labels, and more. Returns issue ID, name, sequence ID, state, priority, assignees, labels, start/target dates, and created date.

Parameters: workspace_slug, project_id, state, priority, assignee, labels, search, parent, cycle, module

Generic CLI call

kosmo integrations:call plane.plane_list_issues '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","state":"example_state","priority":"example_priority","assignee":"example_assignee","labels":"example_labels","search":"example_search","parent":"example_parent"}' --json

Provider shortcut

kosmo integrations:plane plane_list_issues '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","state":"example_state","priority":"example_priority","assignee":"example_assignee","labels":"example_labels","search":"example_search","parent":"example_parent"}' --json

`plane.plane_search_issues`

Read read

Search issues across all projects in a Plane.so workspace. Provide a search query to find issues by name or description. Optionally filter by project, state, priority, or assignee.

Parameters: workspace_slug, search, project, state, priority, assignee

Generic CLI call

kosmo integrations:call plane.plane_search_issues '{"workspace_slug":"example_workspace_slug","search":"example_search","project":"example_project","state":"example_state","priority":"example_priority","assignee":"example_assignee"}' --json

Provider shortcut

kosmo integrations:plane plane_search_issues '{"workspace_slug":"example_workspace_slug","search":"example_search","project":"example_project","state":"example_state","priority":"example_priority","assignee":"example_assignee"}' --json

`plane.plane_get_issue`

Read read

Get detailed information about a single Plane.so issue, including description, state, priority, assignees, labels, dates, and relations. The issue_id may be a UUID or an issue reference like KOS-55 on Plane deployments that support it.

Parameters: workspace_slug, project_id, issue_id

Generic CLI call

kosmo integrations:call plane.plane_get_issue '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id"}' --json

Provider shortcut

kosmo integrations:plane plane_get_issue '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id"}' --json

`plane.plane_create_issue`

Write write

Create a new issue in a Plane.so project. Requires a title. Optionally set description (HTML), state, priority, assignees, labels, start/target dates, and parent issue.

Parameters: workspace_slug, project_id, name, description_html, state, priority, assignees, labels, start_date, target_date, parent

Generic CLI call

kosmo integrations:call plane.plane_create_issue '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","name":"example_name","description_html":"example_description_html","state":"example_state","priority":"example_priority","assignees":"example_assignees","labels":"example_labels"}' --json

Provider shortcut

kosmo integrations:plane plane_create_issue '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","name":"example_name","description_html":"example_description_html","state":"example_state","priority":"example_priority","assignees":"example_assignees","labels":"example_labels"}' --json

`plane.plane_update_issue`

Write write

Update an existing Plane.so issue. Provide only the fields you want to change — name, description, state, priority, assignees, labels, dates, or parent.

Parameters: workspace_slug, project_id, issue_id, name, description_html, state, priority, assignees, labels, start_date, target_date, parent

Generic CLI call

kosmo integrations:call plane.plane_update_issue '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id","name":"example_name","description_html":"example_description_html","state":"example_state","priority":"example_priority","assignees":"example_assignees"}' --json

Provider shortcut

kosmo integrations:plane plane_update_issue '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id","name":"example_name","description_html":"example_description_html","state":"example_state","priority":"example_priority","assignees":"example_assignees"}' --json

`plane.plane_delete_issue`

Write write

Delete an issue from a Plane.so project. This action is permanent and cannot be undone.

Parameters: workspace_slug, project_id, issue_id

Generic CLI call

kosmo integrations:call plane.plane_delete_issue '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id"}' --json

Provider shortcut

kosmo integrations:plane plane_delete_issue '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id"}' --json

`plane.plane_create_comment`

Write write

Add a comment to a Plane.so issue. The comment body should be provided in HTML format.

Parameters: workspace_slug, project_id, issue_id, comment_html

Generic CLI call

kosmo integrations:call plane.plane_create_comment '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id","comment_html":"example_comment_html"}' --json

Provider shortcut

kosmo integrations:plane plane_create_comment '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id","comment_html":"example_comment_html"}' --json

`plane.plane_list_comments`

Read read

List all comments on a Plane.so issue. Returns comment ID, content, author, and timestamps.

Parameters: workspace_slug, project_id, issue_id

Generic CLI call

kosmo integrations:call plane.plane_list_comments '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id"}' --json

Provider shortcut

kosmo integrations:plane plane_list_comments '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id"}' --json

`plane.plane_list_cycles`

Read read

List all cycles in a Plane.so project. Returns cycle ID, name, start/end dates, and progress info.

Parameters: workspace_slug, project_id

Generic CLI call

kosmo integrations:call plane.plane_list_cycles '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

Provider shortcut

kosmo integrations:plane plane_list_cycles '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

`plane.plane_get_cycle`

Read read

Get detailed information about a Plane.so cycle, including name, description, start/end dates, and status.

Parameters: workspace_slug, project_id, cycle_id

Generic CLI call

kosmo integrations:call plane.plane_get_cycle '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","cycle_id":"example_cycle_id"}' --json

Provider shortcut

kosmo integrations:plane plane_get_cycle '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","cycle_id":"example_cycle_id"}' --json

`plane.plane_create_cycle`

Write write

Create a new cycle (sprint) in a Plane.so project. Optionally set name, description, and date range.

Parameters: workspace_slug, project_id, name, description, start_date, end_date

Generic CLI call

kosmo integrations:call plane.plane_create_cycle '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","name":"example_name","description":"example_description","start_date":"example_start_date","end_date":"example_end_date"}' --json

Provider shortcut

kosmo integrations:plane plane_create_cycle '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","name":"example_name","description":"example_description","start_date":"example_start_date","end_date":"example_end_date"}' --json

`plane.plane_add_issue_to_cycle`

Write write

Add an existing issue to a Plane.so cycle. The issue will be tracked within the cycle's sprint/iteration.

Parameters: workspace_slug, project_id, cycle_id, issue_id

Generic CLI call

kosmo integrations:call plane.plane_add_issue_to_cycle '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","cycle_id":"example_cycle_id","issue_id":"example_issue_id"}' --json

Provider shortcut

kosmo integrations:plane plane_add_issue_to_cycle '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","cycle_id":"example_cycle_id","issue_id":"example_issue_id"}' --json

`plane.plane_list_modules`

Read read

List all modules in a Plane.so project. Modules group related issues together (e.g., "Auth System", "Payment Integration"). Returns module ID, name, description, status, and dates.

Parameters: workspace_slug, project_id

Generic CLI call

kosmo integrations:call plane.plane_list_modules '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

Provider shortcut

kosmo integrations:plane plane_list_modules '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

`plane.plane_get_module`

Read read

Get detailed information about a Plane.so module, including name, description, status, dates, and team.

Parameters: workspace_slug, project_id, module_id

Generic CLI call

kosmo integrations:call plane.plane_get_module '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","module_id":"example_module_id"}' --json

Provider shortcut

kosmo integrations:plane plane_get_module '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","module_id":"example_module_id"}' --json

`plane.plane_create_module`

Write write

Create a new module in a Plane.so project. Modules group related issues together (e.g., "Auth System", "Payment Integration"). Optionally set description, status, and date range.

Parameters: workspace_slug, project_id, name, description, status, start_date, target_date

Generic CLI call

kosmo integrations:call plane.plane_create_module '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","name":"example_name","description":"example_description","status":"example_status","start_date":"example_start_date","target_date":"example_target_date"}' --json

Provider shortcut

kosmo integrations:plane plane_create_module '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","name":"example_name","description":"example_description","status":"example_status","start_date":"example_start_date","target_date":"example_target_date"}' --json

`plane.plane_add_issue_to_module`

Write write

Add an existing issue to a Plane.so module. Modules group related issues for feature-based organization.

Parameters: workspace_slug, project_id, module_id, issue_id

Generic CLI call

kosmo integrations:call plane.plane_add_issue_to_module '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","module_id":"example_module_id","issue_id":"example_issue_id"}' --json

Provider shortcut

kosmo integrations:plane plane_add_issue_to_module '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","module_id":"example_module_id","issue_id":"example_issue_id"}' --json

`plane.plane_list_states`

Read read

List all workflow states in a Plane.so project. Returns state UUID, name, group (backlog/unstarted/started/completed/cancelled), and color. Use state UUIDs when creating or updating issues.

Parameters: workspace_slug, project_id

Generic CLI call

kosmo integrations:call plane.plane_list_states '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

Provider shortcut

kosmo integrations:plane plane_list_states '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

`plane.plane_create_state`

Write write

Create a new workflow state in a Plane.so project. States represent issue statuses (e.g., "In Review", "Ready for QA"). Requires a name and group (backlog, unstarted, started, completed, cancelled). Optionally set color and description.

Parameters: workspace_slug, project_id, name, group, color, description, slug

Generic CLI call

kosmo integrations:call plane.plane_create_state '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","name":"example_name","group":"example_group","color":"example_color","description":"example_description","slug":"example_slug"}' --json

Provider shortcut

kosmo integrations:plane plane_create_state '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","name":"example_name","group":"example_group","color":"example_color","description":"example_description","slug":"example_slug"}' --json

`plane.plane_list_labels`

Read read

List all labels in a Plane.so project. Returns label UUID, name, color, and parent label. Use label UUIDs when creating or updating issues.

Parameters: workspace_slug, project_id

Generic CLI call

kosmo integrations:call plane.plane_list_labels '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

Provider shortcut

kosmo integrations:plane plane_list_labels '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

`plane.plane_create_label`

Write write

Create a new label in a Plane.so project. Labels categorize issues (e.g., "bug", "feature", "urgent"). Requires a name. Optionally set color (hex) and description. Supports hierarchical labels via parent UUID.

Parameters: workspace_slug, project_id, name, color, description, parent

Generic CLI call

kosmo integrations:call plane.plane_create_label '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","name":"example_name","color":"example_color","description":"example_description","parent":"example_parent"}' --json

Provider shortcut

kosmo integrations:plane plane_create_label '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","name":"example_name","color":"example_color","description":"example_description","parent":"example_parent"}' --json

`plane.plane_list_pages`

Read read

List all pages in a Plane.so project. Pages are Notion-like documents for notes, specs, and documentation. Returns page ID, name, description, and ownership info.

Parameters: workspace_slug, project_id

Generic CLI call

kosmo integrations:call plane.plane_list_pages '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

Provider shortcut

kosmo integrations:plane plane_list_pages '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

`plane.plane_get_page`

Read read

Get detailed content of a Plane.so page, including the full HTML description.

Parameters: workspace_slug, project_id, page_id

Generic CLI call

kosmo integrations:call plane.plane_get_page '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","page_id":"example_page_id"}' --json

Provider shortcut

kosmo integrations:plane plane_get_page '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","page_id":"example_page_id"}' --json

`plane.plane_create_page`

Write write

Create a new page in a Plane.so project. Pages are Notion-like documents for notes, specs, and documentation. Requires a name. Optionally set HTML content.

Parameters: workspace_slug, project_id, name, description_html

Generic CLI call

kosmo integrations:call plane.plane_create_page '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","name":"example_name","description_html":"example_description_html"}' --json

Provider shortcut

kosmo integrations:plane plane_create_page '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","name":"example_name","description_html":"example_description_html"}' --json

`plane.plane_list_issue_activities`

Read read

List activity/audit events on a Plane.so issue. Returns changes made to the issue (state changes, assignments, updates, comments) with who made them and when.

Parameters: workspace_slug, project_id, issue_id

Generic CLI call

kosmo integrations:call plane.plane_list_issue_activities '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id"}' --json

Provider shortcut

kosmo integrations:plane plane_list_issue_activities '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id"}' --json

`plane.plane_create_issue_link`

Write write

Attach an external link to a Plane.so issue. Provide a title and a valid URL.

Parameters: workspace_slug, project_id, issue_id, title, url

Generic CLI call

kosmo integrations:call plane.plane_create_issue_link '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id","title":"example_title","url":"example_url"}' --json

Provider shortcut

kosmo integrations:plane plane_create_issue_link '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id","title":"example_title","url":"example_url"}' --json

`plane.plane_list_issue_relations`

Read read

List all relations on a Plane.so issue. Relations describe how issues connect: blocking, blocked_by, duplicate, relates_to, start_before, start_after, finish_before, finish_after.

Parameters: workspace_slug, project_id, issue_id

Generic CLI call

kosmo integrations:call plane.plane_list_issue_relations '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id"}' --json

Provider shortcut

kosmo integrations:plane plane_list_issue_relations '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id","issue_id":"example_issue_id"}' --json

`plane.plane_list_members`

Read read

List members of a Plane.so workspace or project. If project_id is provided, returns project members only; otherwise returns all workspace members. Returns member ID, display name, email, and role.

Parameters: workspace_slug, project_id

Generic CLI call

kosmo integrations:call plane.plane_list_members '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

Provider shortcut

kosmo integrations:plane plane_list_members '{"workspace_slug":"example_workspace_slug","project_id":"example_project_id"}' --json

`plane.plane_get_current_user`

Read read

Get the currently authenticated Plane.so user. Returns user ID, display name, email, and avatar. Useful for verifying API credentials and identifying the current user context. On some self-hosted Plane deployments where the user endpoint is unavailable, this falls back to verifying workspace-scoped access.

Parameters: none

Generic CLI call

kosmo integrations:call plane.plane_get_current_user '{}' --json

Provider shortcut

kosmo integrations:plane plane_get_current_user '{}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

`plane.plane_list_workspaces`

List all Plane.so workspaces the authenticated user belongs to. Returns workspace slug, name, and owner info. Use the slug to reference workspaces in other tools.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_list_workspaces --json

Parameter	Type	Required	Description
No parameters.

`plane.plane_list_projects`

List all projects in a Plane.so workspace. Returns project ID, name, identifier, description, and status. Use the project ID to reference projects in other tools.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_list_projects --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug (e.g., "my-team").

`plane.plane_get_project`

Get detailed information about a Plane.so project, including name, identifier, description, status, dates, and settings.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_get_project --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.

`plane.plane_create_project`

Create a new project in a Plane.so workspace. Requires a name and identifier (short code, e.g., "PROJ"). Optionally set description, cover image, project lead, and default assignee.

Operation: Write write
Schema command: kosmo integrations:schema plane.plane_create_project --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`name`	string	yes	Project name.
`identifier`	string	yes	Short identifier for the project (e.g., "PROJ", max 12 chars).
`description`	string	no	Project description.
`cover_image`	string	no	URL for the project cover image.
`project_lead`	string	no	UUID of the project lead member.
`default_assignee`	string	no	UUID of the default assignee for new issues.

`plane.plane_archive_project`

Archive a Plane.so project. Archived projects are hidden from active views but retain all data.

Operation: Write write
Schema command: kosmo integrations:schema plane.plane_archive_project --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID to archive.

`plane.plane_list_issues`

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_list_issues --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`state`	string	no	Filter by state UUID.
`priority`	string	no	Filter by priority: urgent, high, medium, low, none.
`assignee`	string	no	Filter by assignee UUID.
`labels`	string	no	Comma-separated label UUIDs to filter by.
`search`	string	no	Search query to filter issues by name.
`parent`	string	no	Filter by parent issue UUID.
`cycle`	string	no	Filter by cycle UUID.
`module`	string	no	Filter by module UUID.

`plane.plane_search_issues`

Search issues across all projects in a Plane.so workspace. Provide a search query to find issues by name or description. Optionally filter by project, state, priority, or assignee.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_search_issues --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`search`	string	yes	Search query to find issues.
`project`	string	no	Filter by project UUID.
`state`	string	no	Filter by state UUID.
`priority`	string	no	Filter by priority: urgent, high, medium, low, none.
`assignee`	string	no	Filter by assignee UUID.

`plane.plane_get_issue`

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_get_issue --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`issue_id`	string	yes	The issue UUID or reference (for example KOS-55).

`plane.plane_create_issue`

Create a new issue in a Plane.so project. Requires a title. Optionally set description (HTML), state, priority, assignees, labels, start/target dates, and parent issue.

Operation: Write write
Schema command: kosmo integrations:schema plane.plane_create_issue --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`name`	string	yes	Issue title.
`description_html`	string	no	Issue description in HTML format.
`state`	string	no	State UUID to set the initial status.
`priority`	string	no	Priority level: urgent, high, medium, low, none.
`assignees`	array	no	Array of user UUIDs to assign.
`labels`	array	no	Array of label UUIDs.
`start_date`	string	no	Start date (YYYY-MM-DD).
`target_date`	string	no	Target/due date (YYYY-MM-DD).
`parent`	string	no	Parent issue UUID for sub-issues.

`plane.plane_update_issue`

Update an existing Plane.so issue. Provide only the fields you want to change — name, description, state, priority, assignees, labels, dates, or parent.

Operation: Write write
Schema command: kosmo integrations:schema plane.plane_update_issue --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`issue_id`	string	yes	The issue UUID.
`name`	string	no	New issue title.
`description_html`	string	no	New description in HTML format.
`state`	string	no	New state UUID.
`priority`	string	no	New priority: urgent, high, medium, low, none.
`assignees`	array	no	New array of assignee UUIDs (replaces existing).
`labels`	array	no	New array of label UUIDs (replaces existing).
`start_date`	string	no	New start date (YYYY-MM-DD).
`target_date`	string	no	New target/due date (YYYY-MM-DD).
`parent`	string	no	New parent issue UUID.

`plane.plane_delete_issue`

Delete an issue from a Plane.so project. This action is permanent and cannot be undone.

Operation: Write write
Schema command: kosmo integrations:schema plane.plane_delete_issue --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`issue_id`	string	yes	The issue UUID to delete.

`plane.plane_create_comment`

Add a comment to a Plane.so issue. The comment body should be provided in HTML format.

Operation: Write write
Schema command: kosmo integrations:schema plane.plane_create_comment --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`issue_id`	string	yes	The issue UUID.
`comment_html`	string	yes	Comment content in HTML format.

`plane.plane_list_comments`

List all comments on a Plane.so issue. Returns comment ID, content, author, and timestamps.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_list_comments --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`issue_id`	string	yes	The issue UUID.

`plane.plane_list_cycles`

List all cycles in a Plane.so project. Returns cycle ID, name, start/end dates, and progress info.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_list_cycles --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.

`plane.plane_get_cycle`

Get detailed information about a Plane.so cycle, including name, description, start/end dates, and status.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_get_cycle --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`cycle_id`	string	yes	The cycle UUID.

`plane.plane_create_cycle`

Create a new cycle (sprint) in a Plane.so project. Optionally set name, description, and date range.

Operation: Write write
Schema command: kosmo integrations:schema plane.plane_create_cycle --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`name`	string	no	Cycle name (e.g., "Sprint 14").
`description`	string	no	Cycle description.
`start_date`	string	no	Start date (YYYY-MM-DD).
`end_date`	string	no	End date (YYYY-MM-DD).

`plane.plane_add_issue_to_cycle`

Add an existing issue to a Plane.so cycle. The issue will be tracked within the cycle's sprint/iteration.

Operation: Write write
Schema command: kosmo integrations:schema plane.plane_add_issue_to_cycle --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`cycle_id`	string	yes	The cycle UUID.
`issue_id`	string	yes	The issue UUID to add to the cycle.

`plane.plane_list_modules`

List all modules in a Plane.so project. Modules group related issues together (e.g., "Auth System", "Payment Integration"). Returns module ID, name, description, status, and dates.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_list_modules --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.

`plane.plane_get_module`

Get detailed information about a Plane.so module, including name, description, status, dates, and team.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_get_module --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`module_id`	string	yes	The module UUID.

`plane.plane_create_module`

Create a new module in a Plane.so project. Modules group related issues together (e.g., "Auth System", "Payment Integration"). Optionally set description, status, and date range.

Operation: Write write
Schema command: kosmo integrations:schema plane.plane_create_module --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`name`	string	yes	Module name.
`description`	string	no	Module description.
`status`	string	no	Module status (e.g., "planning", "in_progress", "completed").
`start_date`	string	no	Start date (YYYY-MM-DD).
`target_date`	string	no	Target date (YYYY-MM-DD).

`plane.plane_add_issue_to_module`

Add an existing issue to a Plane.so module. Modules group related issues for feature-based organization.

Operation: Write write
Schema command: kosmo integrations:schema plane.plane_add_issue_to_module --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`module_id`	string	yes	The module UUID.
`issue_id`	string	yes	The issue UUID to add to the module.

`plane.plane_list_states`

List all workflow states in a Plane.so project. Returns state UUID, name, group (backlog/unstarted/started/completed/cancelled), and color. Use state UUIDs when creating or updating issues.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_list_states --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.

`plane.plane_create_state`

Operation: Write write
Schema command: kosmo integrations:schema plane.plane_create_state --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`name`	string	yes	State name (e.g., "In Review").
`group`	string	yes	State group: backlog, unstarted, started, completed, cancelled.
`color`	string	no	Hex color code (e.g., "#FF5733").
`description`	string	no	State description.
`slug`	string	no	URL-friendly slug (auto-generated if omitted).

`plane.plane_list_labels`

List all labels in a Plane.so project. Returns label UUID, name, color, and parent label. Use label UUIDs when creating or updating issues.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_list_labels --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.

`plane.plane_create_label`

Operation: Write write
Schema command: kosmo integrations:schema plane.plane_create_label --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`name`	string	yes	Label name.
`color`	string	no	Hex color code (e.g., "#FF5733").
`description`	string	no	Label description.
`parent`	string	no	Parent label UUID for hierarchical labels.

`plane.plane_list_pages`

List all pages in a Plane.so project. Pages are Notion-like documents for notes, specs, and documentation. Returns page ID, name, description, and ownership info.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_list_pages --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.

`plane.plane_get_page`

Get detailed content of a Plane.so page, including the full HTML description.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_get_page --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`page_id`	string	yes	The page UUID.

`plane.plane_create_page`

Create a new page in a Plane.so project. Pages are Notion-like documents for notes, specs, and documentation. Requires a name. Optionally set HTML content.

Operation: Write write
Schema command: kosmo integrations:schema plane.plane_create_page --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`name`	string	yes	Page title.
`description_html`	string	no	Page content in HTML format.

`plane.plane_list_issue_activities`

List activity/audit events on a Plane.so issue. Returns changes made to the issue (state changes, assignments, updates, comments) with who made them and when.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_list_issue_activities --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`issue_id`	string	yes	The issue UUID.

`plane.plane_create_issue_link`

Attach an external link to a Plane.so issue. Provide a title and a valid URL.

Operation: Write write
Schema command: kosmo integrations:schema plane.plane_create_issue_link --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`issue_id`	string	yes	The issue UUID.
`title`	string	yes	Display title for the link.
`url`	string	yes	The URL to link to.

`plane.plane_list_issue_relations`

List all relations on a Plane.so issue. Relations describe how issues connect: blocking, blocked_by, duplicate, relates_to, start_before, start_after, finish_before, finish_after.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_list_issue_relations --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	yes	The project UUID.
`issue_id`	string	yes	The issue UUID.

`plane.plane_list_members`

List members of a Plane.so workspace or project. If project_id is provided, returns project members only; otherwise returns all workspace members. Returns member ID, display name, email, and role.

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_list_members --json

Parameter	Type	Required	Description
`workspace_slug`	string	no	The workspace slug.
`project_id`	string	no	Optional project UUID to list project-specific members.

`plane.plane_get_current_user`

Operation: Read read
Schema command: kosmo integrations:schema plane.plane_get_current_user --json

Parameter	Type	Required	Description
No parameters.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.