Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Plane MCP connector

OAuth 2.1/DCR Project ManagementProductivity

Connect to Plane MCP. Manage projects, work items, cycles, modules, epics, and initiatives in your Plane workspace from AI workflows.

Plane MCP connector

  1. Install the SDK

    Section titled “Install the SDK”
    Terminal window
    npm install @scalekit-sdk/node

    Full SDK reference: Node.js | Python

  2. Set your credentials

    Section titled “Set your credentials”

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>

  3. Authorize and make your first call

    Section titled “Authorize and make your first call”
    quickstart.ts
    import { ScalekitClient } from '@scalekit-sdk/node'
    import 'dotenv/config'
    

    const scalekit = new ScalekitClient(
      process.env.SCALEKIT_ENV_URL,
      process.env.SCALEKIT_CLIENT_ID,
      process.env.SCALEKIT_CLIENT_SECRET,
    )
    const actions = scalekit.actions
    

    const connector = 'planemcp'
    const identifier = 'user_123'
    

    // Generate an authorization link for the user
    const { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })
    console.log('Authorize Plane MCP:', link)
    process.stdout.write('Press Enter after authorizing...')
    await new Promise(r => process.stdin.once('data', r))
    

    // Make your first call
    const result = await actions.executeTool({
      connector,
      identifier,
      toolName: 'planemcp_get_me',
      toolInput: {},
    })
    console.log(result)

What you can do

Section titled “What you can do”

Connect this agent connector to let your agent:

  • Update workspace features, work log, work item type — Enable or disable feature flags for the workspace
  • Module unarchive, retrieve, remove work item from — Restore an archived module to active status
  • Cycle unarchive, retrieve, remove work item from — Restore an archived cycle to active status
  • Items transfer cycle work — Move all incomplete work items from one cycle to another
  • Search work items — Search for work items by name or description across the workspace
  • Page retrieve workspace, retrieve project — Retrieve the content and metadata of a workspace-level page

Tool list

Section titled “Tool list”

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

planemcp_add_work_items_to_cycle # Add one or more work items to a cycle by their UUIDs. 3 params

Add one or more work items to a cycle by their UUIDs.

Name Type Required Description
cycle_id string required UUID of the cycle. Get it from List Cycles.
issue_ids array required List of work item UUIDs to add.
project_id string required UUID of the project. Get it from List Projects.
planemcp_add_work_items_to_milestone # Add one or more work items to a milestone. 3 params

Add one or more work items to a milestone.

Name Type Required Description
issue_ids array required List of work item UUIDs to add.
milestone_id string required UUID of the milestone. Get it from List Milestones.
project_id string required UUID of the project. Get it from List Projects.
planemcp_add_work_items_to_module # Add one or more work items to a module. 3 params

Add one or more work items to a module.

Name Type Required Description
issue_ids array required List of work item UUIDs to add.
module_id string required UUID of the module. Get it from List Modules.
project_id string required UUID of the project. Get it from List Projects.
planemcp_archive_cycle # Archive a cycle so it no longer appears in active views. 2 params

Archive a cycle so it no longer appears in active views.

Name Type Required Description
cycle_id string required UUID of the cycle. Get it from List Cycles.
project_id string required UUID of the project. Get it from List Projects.
planemcp_archive_module # Archive a module so it no longer appears in active views. 2 params

Archive a module so it no longer appears in active views.

Name Type Required Description
module_id string required UUID of the module. Get it from List Modules.
project_id string required UUID of the project. Get it from List Projects.
planemcp_create_cycle # Create a new cycle (sprint) in a project with a name and date range. 9 params

Create a new cycle (sprint) in a project with a name and date range.

Name Type Required Description
name string required Name or title of the item.
owned_by string required UUID of the member who owns this item.
project_id string required UUID of the project. Get it from List Projects.
description string optional Optional description.
end_date string optional End date in ISO 8601 format (YYYY-MM-DD).
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
start_date string optional Start date in ISO 8601 format (YYYY-MM-DD).
timezone string optional IANA timezone name (e.g. America/New_York).
planemcp_create_epic # Create a new epic in a project. 17 params

Create a new epic in a project.

Name Type Required Description
name string required Name or title of the item.
project_id string required UUID of the project. Get it from List Projects.
assignees string optional List of user UUIDs to assign to the work item.
description_html string optional HTML-formatted description of the work item.
description_stripped string optional Plain text description with HTML tags removed.
estimate_point string optional Estimation point value.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
is_draft string optional If true, saves the item as a draft.
labels string optional List of label UUIDs to attach to the work item.
parent string optional UUID of the parent work item.
point string optional Story point value for the work item.
priority string optional Priority level. Accepted values: urgent, high, medium, low, none.
sort_order string optional Float value for manual sort ordering.
start_date string optional Start date in ISO 8601 format (YYYY-MM-DD).
state string optional UUID of the workflow state to assign.
target_date string optional Target completion date in ISO 8601 format (YYYY-MM-DD).
planemcp_create_initiative # Create a new initiative in the workspace. 7 params

Create a new initiative in the workspace.

Name Type Required Description
name string required Name or title of the item.
description_html string optional HTML-formatted description of the work item.
end_date string optional End date in ISO 8601 format (YYYY-MM-DD).
lead string optional UUID of the lead member.
logo_props string optional No description.
start_date string optional Start date in ISO 8601 format (YYYY-MM-DD).
state string optional UUID of the workflow state to assign.
planemcp_create_intake_work_item # Submit a new work item to the project intake queue. 2 params

Submit a new work item to the project intake queue.

Name Type Required Description
data object required No description.
project_id string required UUID of the project. Get it from List Projects.
planemcp_create_label # Create a new label in a project for categorizing work items. 8 params

Create a new label in a project for categorizing work items.

Name Type Required Description
name string required Name or title of the item.
project_id string required UUID of the project. Get it from List Projects.
color string optional Hex color code for the item (e.g. #FF6B6B).
description string optional Optional description.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
parent string optional UUID of the parent work item.
sort_order string optional Float value for manual sort ordering.
planemcp_create_milestone # Create a new milestone in a project. 5 params

Create a new milestone in a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
title string required Title of the page or item.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
target_date string optional Target completion date in ISO 8601 format (YYYY-MM-DD).
planemcp_create_module # Create a new module in a project to group related work items. 10 params

Create a new module in a project to group related work items.

Name Type Required Description
name string required Name or title of the item.
project_id string required UUID of the project. Get it from List Projects.
description string optional Optional description.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
lead string optional UUID of the lead member.
members string optional List of member user UUIDs.
start_date string optional Start date in ISO 8601 format (YYYY-MM-DD).
status string optional Status filter for the query.
target_date string optional Target completion date in ISO 8601 format (YYYY-MM-DD).
planemcp_create_project # Create a new project in the workspace. 19 params

Create a new project in the workspace.

Name Type Required Description
identifier string required Workspace slug identifier.
name string required Name or title of the item.
archive_in string optional Number of days after which completed cycles are archived.
close_in string optional Number of days after which completed cycles are closed.
cover_image string optional URL of the cover image.
cycle_view string optional Whether to show the cycle view.
default_assignee string optional UUID of the default assignee for new work items.
description string optional Optional description.
emoji string optional Emoji icon for the item.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
guest_view_all_features string optional Whether guests can view all features.
intake_view string optional Whether to show the intake view.
is_issue_type_enabled string optional Whether work item types are enabled for the project.
issue_views_view string optional Whether to show issue views.
module_view string optional Whether to show the module view.
page_view string optional Whether to show the page view.
project_lead string optional UUID of the project lead member.
timezone string optional IANA timezone name (e.g. America/New_York).
planemcp_create_project_page # Create a new page within a project. 11 params

Create a new page within a project.

Name Type Required Description
description_html string required HTML-formatted description of the work item.
name string required Name or title of the item.
project_id string required UUID of the project. Get it from List Projects.
access string optional Access level (0 = secret, 1 = public).
archived_at string optional Timestamp when the item was archived.
color string optional Hex color code for the item (e.g. #FF6B6B).
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
is_locked string optional Whether the page is locked for editing.
logo_props string optional No description.
view_props string optional No description.
planemcp_create_state # Create a new workflow state in a project. 10 params

Create a new workflow state in a project.

Name Type Required Description
color string required Hex color code for the item (e.g. #FF6B6B).
name string required Name or title of the item.
project_id string required UUID of the project. Get it from List Projects.
default string optional Whether this is the default item.
description string optional Optional description.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
group string optional Group identifier.
is_triage string optional Whether this is a triage intake.
sequence string optional Sequence number for ordering.
planemcp_create_work_item # Create a new work item (issue) in a project. 19 params

Create a new work item (issue) in a project.

Name Type Required Description
name string required Name or title of the item.
project_id string required UUID of the project. Get it from List Projects.
assignees string optional List of user UUIDs to assign to the work item.
description_html string optional HTML-formatted description of the work item.
description_stripped string optional Plain text description with HTML tags removed.
estimate_point string optional Estimation point value.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
is_draft string optional If true, saves the item as a draft.
labels string optional List of label UUIDs to attach to the work item.
parent string optional UUID of the parent work item.
point string optional Story point value for the work item.
priority string optional Priority level. Accepted values: urgent, high, medium, low, none.
sort_order string optional Float value for manual sort ordering.
start_date string optional Start date in ISO 8601 format (YYYY-MM-DD).
state string optional UUID of the workflow state to assign.
target_date string optional Target completion date in ISO 8601 format (YYYY-MM-DD).
type string optional Type identifier for the item.
type_id string optional UUID of the work item type.
planemcp_create_work_item_comment # Add a comment to a work item. 7 params

Add a comment to a work item.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
access string optional Access level (0 = secret, 1 = public).
comment_html string optional HTML content of the comment.
comment_json string optional No description.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
planemcp_create_work_item_property # Create a custom property for work items in a project. 15 params

Create a custom property for work items in a project.

Name Type Required Description
display_name string required Display label for the custom property.
project_id string required UUID of the project. Get it from List Projects.
property_type string required Data type of the custom property. Accepted values: text, number, boolean, datetime, option, relation.
type_id string required UUID of the work item type.
default_value string optional Default selected option values for the property.
description string optional Optional description.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
is_active string optional Whether this item is active.
is_multi string optional Whether the property allows multiple values.
is_required string optional Whether the property is required.
options string optional No description.
relation_type string optional Type of work item relation. Accepted values: blocked_by, blocking, duplicate_of, duplicate.
settings string optional No description.
validation_rules string optional No description.
planemcp_create_work_item_relation # Create a relation between two work items (e.g. blocked_by, duplicate). 4 params

Create a relation between two work items (e.g. blocked_by, duplicate).

Name Type Required Description
issues array required List of work item UUIDs to create relations for.
project_id string required UUID of the project. Get it from List Projects.
relation_type string required Type of work item relation. Accepted values: blocked_by, blocking, duplicate_of, duplicate.
work_item_id string required UUID of the work item.
planemcp_create_work_item_type # Create a custom work item type for a project. 8 params

Create a custom work item type for a project.

Name Type Required Description
name string required Name or title of the item.
project_id string required UUID of the project. Get it from List Projects.
description string optional Optional description.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
is_active string optional Whether this item is active.
is_epic string optional Whether this work item is an epic.
project_ids string optional List of project UUIDs to filter by.
planemcp_create_work_log # Log time spent on a work item. 4 params

Log time spent on a work item.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
description string optional Optional description.
duration string optional Duration in minutes.
planemcp_create_workspace_page # Create a new page at the workspace level. 10 params

Create a new page at the workspace level.

Name Type Required Description
description_html string required HTML-formatted description of the work item.
name string required Name or title of the item.
access string optional Access level (0 = secret, 1 = public).
archived_at string optional Timestamp when the item was archived.
color string optional Hex color code for the item (e.g. #FF6B6B).
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
is_locked string optional Whether the page is locked for editing.
logo_props string optional No description.
view_props string optional No description.
planemcp_delete_cycle # Permanently delete a cycle from a project. 2 params

Permanently delete a cycle from a project.

Name Type Required Description
cycle_id string required UUID of the cycle. Get it from List Cycles.
project_id string required UUID of the project. Get it from List Projects.
planemcp_delete_epic # Permanently delete an epic from a project. 2 params

Permanently delete an epic from a project.

Name Type Required Description
epic_id string required UUID of the epic. Get it from List Epics.
project_id string required UUID of the project. Get it from List Projects.
planemcp_delete_initiative # Permanently delete a workspace initiative. 1 param

Permanently delete a workspace initiative.

Name Type Required Description
initiative_id string required UUID of the initiative. Get it from List Initiatives.
planemcp_delete_intake_work_item # Delete a work item from the intake queue. 2 params

Delete a work item from the intake queue.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
planemcp_delete_label # Permanently delete a label from a project. 2 params

Permanently delete a label from a project.

Name Type Required Description
label_id string required UUID of the label. Get it from List Labels.
project_id string required UUID of the project. Get it from List Projects.
planemcp_delete_milestone # Permanently delete a milestone from a project. 2 params

Permanently delete a milestone from a project.

Name Type Required Description
milestone_id string required UUID of the milestone. Get it from List Milestones.
project_id string required UUID of the project. Get it from List Projects.
planemcp_delete_module # Permanently delete a module from a project. 2 params

Permanently delete a module from a project.

Name Type Required Description
module_id string required UUID of the module. Get it from List Modules.
project_id string required UUID of the project. Get it from List Projects.
planemcp_delete_project # Permanently delete a project and all its contents. 1 param

Permanently delete a project and all its contents.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
planemcp_delete_state # Permanently delete a workflow state from a project. 2 params

Permanently delete a workflow state from a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
state_id string required UUID of the state. Get it from List States.
planemcp_delete_work_item # Permanently delete a work item. 2 params

Permanently delete a work item.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
planemcp_delete_work_item_comment # Delete a comment from a work item. 3 params

Delete a comment from a work item.

Name Type Required Description
comment_id string required UUID of the comment.
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
planemcp_delete_work_item_property # Delete a custom property from a project. 3 params

Delete a custom property from a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
type_id string required UUID of the work item type.
work_item_property_id string required UUID of the custom work item property.
planemcp_delete_work_item_type # Delete a custom work item type from a project. 2 params

Delete a custom work item type from a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_type_id string required UUID of the work item type.
planemcp_delete_work_log # Delete a work log entry from a work item. 3 params

Delete a work log entry from a work item.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
work_log_id string required UUID of the work log entry.
planemcp_get_me # Retrieve the profile of the currently authenticated user. 0 params

Retrieve the profile of the currently authenticated user.

planemcp_get_project_features # Retrieve the enabled feature flags for a project. 1 param

Retrieve the enabled feature flags for a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
planemcp_get_project_members # Retrieve the list of members in a project. 2 params

Retrieve the list of members in a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
params string optional No description.
planemcp_get_project_worklog_summary # Retrieve a summary of work logs for a project. 1 param

Retrieve a summary of work logs for a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
planemcp_get_workspace_features # Retrieve the enabled feature flags for the workspace. 0 params

Retrieve the enabled feature flags for the workspace.

planemcp_get_workspace_members # Retrieve the list of members in the workspace. 0 params

Retrieve the list of members in the workspace.

planemcp_list_archived_cycles # Retrieve all archived cycles in a project. 2 params

Retrieve all archived cycles in a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
params string optional No description.
planemcp_list_archived_modules # Retrieve all archived modules in a project. 2 params

Retrieve all archived modules in a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
params string optional No description.
planemcp_list_cycle_work_items # Retrieve all work items in a cycle. 3 params

Retrieve all work items in a cycle.

Name Type Required Description
cycle_id string required UUID of the cycle. Get it from List Cycles.
project_id string required UUID of the project. Get it from List Projects.
params string optional No description.
planemcp_list_cycles # Retrieve all cycles (sprints) in a project. 2 params

Retrieve all cycles (sprints) in a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
params string optional No description.
planemcp_list_epics # Retrieve all epics in a project. 3 params

Retrieve all epics in a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
cursor string optional Pagination cursor from the previous response.
per_page string optional Number of items per page.
planemcp_list_initiatives # Retrieve all initiatives in the workspace. 1 param

Retrieve all initiatives in the workspace.

Name Type Required Description
params string optional No description.
planemcp_list_intake_work_items # Retrieve all work items in the project intake queue. 2 params

Retrieve all work items in the project intake queue.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
params string optional No description.
planemcp_list_labels # Retrieve all labels in a project. 2 params

Retrieve all labels in a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
params string optional No description.
planemcp_list_milestone_work_items # Retrieve all work items assigned to a milestone. 3 params

Retrieve all work items assigned to a milestone.

Name Type Required Description
milestone_id string required UUID of the milestone. Get it from List Milestones.
project_id string required UUID of the project. Get it from List Projects.
params string optional No description.
planemcp_list_milestones # Retrieve all milestones in a project. 2 params

Retrieve all milestones in a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
params string optional No description.
planemcp_list_module_work_items # Retrieve all work items in a module. 3 params

Retrieve all work items in a module.

Name Type Required Description
module_id string required UUID of the module. Get it from List Modules.
project_id string required UUID of the project. Get it from List Projects.
params string optional No description.
planemcp_list_modules # Retrieve all modules in a project. 2 params

Retrieve all modules in a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
params string optional No description.
planemcp_list_projects # Retrieve all projects in the workspace. 5 params

Retrieve all projects in the workspace.

Name Type Required Description
cursor string optional Pagination cursor from the previous response.
expand string optional Comma-separated list of fields to expand in the response.
fields string optional Comma-separated list of fields to include in the response.
order_by string optional Field to sort results by (e.g. -created_at for descending).
per_page string optional Number of items per page.
planemcp_list_states # Retrieve all workflow states in a project. 2 params

Retrieve all workflow states in a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
params string optional No description.
planemcp_list_work_item_activities # Retrieve the activity history for a work item. 3 params

Retrieve the activity history for a work item.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
params string optional No description.
planemcp_list_work_item_comments # Retrieve all comments on a work item. 3 params

Retrieve all comments on a work item.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
params string optional No description.
planemcp_list_work_item_properties # Retrieve all custom properties defined in a project. 3 params

Retrieve all custom properties defined in a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
type_id string required UUID of the work item type.
params string optional No description.
planemcp_list_work_item_relations # Retrieve all relations for a work item. 2 params

Retrieve all relations for a work item.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
planemcp_list_work_item_types # Retrieve all custom work item types in a project. 2 params

Retrieve all custom work item types in a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
params string optional No description.
planemcp_list_work_items # Retrieve work items in a project with optional filters and pagination. 21 params

Retrieve work items in a project with optional filters and pagination.

Name Type Required Description
assignee_ids string optional List of user UUIDs to assign.
created_by_ids string optional List of user UUIDs to filter by creator.
cursor string optional Pagination cursor from the previous response.
cycle_ids string optional List of cycle UUIDs.
expand string optional Comma-separated list of fields to expand in the response.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
fields string optional Comma-separated list of fields to include in the response.
is_archived string optional Whether to include archived items.
label_ids string optional List of label UUIDs to attach.
limit string optional Maximum number of items to return.
module_ids string optional List of module UUIDs to add the work item to.
order_by string optional Field to sort results by (e.g. -created_at for descending).
per_page string optional Number of items per page.
priorities string optional List of priority values to filter by.
project_id string optional UUID of the project. Get it from List Projects.
query string optional Text query to search work items by name or description.
state_groups string optional List of state groups to filter by (e.g. started, unstarted).
state_ids string optional List of state UUIDs to filter by.
type_ids string optional List of work item type UUIDs to filter by.
workspace_search boolean optional If true, searches across all projects in the workspace.
planemcp_list_work_logs # Retrieve all work log entries for a work item. 3 params

Retrieve all work log entries for a work item.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
params string optional No description.
planemcp_remove_work_item_from_cycle # Remove a work item from a cycle. 3 params

Remove a work item from a cycle.

Name Type Required Description
cycle_id string required UUID of the cycle. Get it from List Cycles.
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
planemcp_remove_work_item_from_module # Remove a work item from a module. 3 params

Remove a work item from a module.

Name Type Required Description
module_id string required UUID of the module. Get it from List Modules.
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
planemcp_remove_work_item_relation # Delete a relation between two work items. 3 params

Delete a relation between two work items.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
related_issue string required UUID of the related work item.
work_item_id string required UUID of the work item.
planemcp_remove_work_items_from_milestone # Remove one or more work items from a milestone. 3 params

Remove one or more work items from a milestone.

Name Type Required Description
issue_ids array required List of work item UUIDs to add.
milestone_id string required UUID of the milestone. Get it from List Milestones.
project_id string required UUID of the project. Get it from List Projects.
planemcp_retrieve_cycle # Retrieve details of a specific cycle by its ID. 2 params

Retrieve details of a specific cycle by its ID.

Name Type Required Description
cycle_id string required UUID of the cycle. Get it from List Cycles.
project_id string required UUID of the project. Get it from List Projects.
planemcp_retrieve_epic # Retrieve details of a specific epic by its ID. 2 params

Retrieve details of a specific epic by its ID.

Name Type Required Description
epic_id string required UUID of the epic. Get it from List Epics.
project_id string required UUID of the project. Get it from List Projects.
planemcp_retrieve_initiative # Retrieve details of a specific initiative by its ID. 1 param

Retrieve details of a specific initiative by its ID.

Name Type Required Description
initiative_id string required UUID of the initiative. Get it from List Initiatives.
planemcp_retrieve_intake_work_item # Retrieve a specific work item from the intake queue. 3 params

Retrieve a specific work item from the intake queue.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
params string optional No description.
planemcp_retrieve_label # Retrieve details of a specific label by its ID. 2 params

Retrieve details of a specific label by its ID.

Name Type Required Description
label_id string required UUID of the label. Get it from List Labels.
project_id string required UUID of the project. Get it from List Projects.
planemcp_retrieve_milestone # Retrieve details of a specific milestone by its ID. 2 params

Retrieve details of a specific milestone by its ID.

Name Type Required Description
milestone_id string required UUID of the milestone. Get it from List Milestones.
project_id string required UUID of the project. Get it from List Projects.
planemcp_retrieve_module # Retrieve details of a specific module by its ID. 2 params

Retrieve details of a specific module by its ID.

Name Type Required Description
module_id string required UUID of the module. Get it from List Modules.
project_id string required UUID of the project. Get it from List Projects.
planemcp_retrieve_project # Retrieve details of a specific project by its ID. 1 param

Retrieve details of a specific project by its ID.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
planemcp_retrieve_project_page # Retrieve the content and metadata of a project page. 2 params

Retrieve the content and metadata of a project page.

Name Type Required Description
page_id string required UUID of the page.
project_id string required UUID of the project. Get it from List Projects.
planemcp_retrieve_state # Retrieve details of a specific workflow state by its ID. 2 params

Retrieve details of a specific workflow state by its ID.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
state_id string required UUID of the state. Get it from List States.
planemcp_retrieve_work_item # Retrieve details of a specific work item by its UUID. 7 params

Retrieve details of a specific work item by its UUID.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
expand string optional Comma-separated list of fields to expand in the response.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
fields string optional Comma-separated list of fields to include in the response.
order_by string optional Field to sort results by (e.g. -created_at for descending).
planemcp_retrieve_work_item_activity # Retrieve a specific activity entry from a work item's history. 3 params

Retrieve a specific activity entry from a work item's history.

Name Type Required Description
activity_id string required UUID of the activity entry.
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
planemcp_retrieve_work_item_by_identifier # Retrieve a work item using its short project-scoped identifier (e.g. PRJ-42). 7 params

Retrieve a work item using its short project-scoped identifier (e.g. PRJ-42).

Name Type Required Description
issue_identifier integer required Numeric sequence identifier of the work item within the project.
project_identifier string required Short project identifier prefix (e.g. PRJ).
expand string optional Comma-separated list of fields to expand in the response.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
fields string optional Comma-separated list of fields to include in the response.
order_by string optional Field to sort results by (e.g. -created_at for descending).
planemcp_retrieve_work_item_comment # Retrieve a specific comment from a work item. 3 params

Retrieve a specific comment from a work item.

Name Type Required Description
comment_id string required UUID of the comment.
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
planemcp_retrieve_work_item_property # Retrieve a specific custom property definition from a project. 3 params

Retrieve a specific custom property definition from a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
type_id string required UUID of the work item type.
work_item_property_id string required UUID of the custom work item property.
planemcp_retrieve_work_item_type # Retrieve a specific custom work item type from a project. 2 params

Retrieve a specific custom work item type from a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_type_id string required UUID of the work item type.
planemcp_retrieve_workspace_page # Retrieve the content and metadata of a workspace-level page. 1 param

Retrieve the content and metadata of a workspace-level page.

Name Type Required Description
page_id string required UUID of the page.
planemcp_search_work_items # Search for work items by name or description across the workspace. 6 params

Search for work items by name or description across the workspace.

Name Type Required Description
query string required Text query to search work items by name or description.
expand string optional Comma-separated list of fields to expand in the response.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
fields string optional Comma-separated list of fields to include in the response.
order_by string optional Field to sort results by (e.g. -created_at for descending).
planemcp_transfer_cycle_work_items # Move all incomplete work items from one cycle to another. 3 params

Move all incomplete work items from one cycle to another.

Name Type Required Description
cycle_id string required UUID of the cycle. Get it from List Cycles.
new_cycle_id string required UUID of the cycle to transfer work items to.
project_id string required UUID of the project. Get it from List Projects.
planemcp_unarchive_cycle # Restore an archived cycle to active status. 2 params

Restore an archived cycle to active status.

Name Type Required Description
cycle_id string required UUID of the cycle. Get it from List Cycles.
project_id string required UUID of the project. Get it from List Projects.
planemcp_unarchive_module # Restore an archived module to active status. 2 params

Restore an archived module to active status.

Name Type Required Description
module_id string required UUID of the module. Get it from List Modules.
project_id string required UUID of the project. Get it from List Projects.
planemcp_update_cycle # Update the name, dates, or other properties of a cycle. 10 params

Update the name, dates, or other properties of a cycle.

Name Type Required Description
cycle_id string required UUID of the cycle. Get it from List Cycles.
project_id string required UUID of the project. Get it from List Projects.
description string optional Optional description.
end_date string optional End date in ISO 8601 format (YYYY-MM-DD).
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
name string optional Name or title of the item.
owned_by string optional UUID of the member who owns this item.
start_date string optional Start date in ISO 8601 format (YYYY-MM-DD).
timezone string optional IANA timezone name (e.g. America/New_York).
planemcp_update_epic # Update the properties of an existing epic. 17 params

Update the properties of an existing epic.

Name Type Required Description
epic_id string required UUID of the epic. Get it from List Epics.
project_id string required UUID of the project. Get it from List Projects.
assignees string optional List of user UUIDs to assign to the work item.
description_html string optional HTML-formatted description of the work item.
description_stripped string optional Plain text description with HTML tags removed.
estimate_point string optional Estimation point value.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
is_draft string optional If true, saves the item as a draft.
labels string optional List of label UUIDs to attach to the work item.
name string optional Name or title of the item.
point string optional Story point value for the work item.
priority string optional Priority level. Accepted values: urgent, high, medium, low, none.
sort_order string optional Float value for manual sort ordering.
start_date string optional Start date in ISO 8601 format (YYYY-MM-DD).
state string optional UUID of the workflow state to assign.
target_date string optional Target completion date in ISO 8601 format (YYYY-MM-DD).
planemcp_update_initiative # Update the properties of a workspace initiative. 8 params

Update the properties of a workspace initiative.

Name Type Required Description
initiative_id string required UUID of the initiative. Get it from List Initiatives.
description_html string optional HTML-formatted description of the work item.
end_date string optional End date in ISO 8601 format (YYYY-MM-DD).
lead string optional UUID of the lead member.
logo_props string optional No description.
name string optional Name or title of the item.
start_date string optional Start date in ISO 8601 format (YYYY-MM-DD).
state string optional UUID of the workflow state to assign.
planemcp_update_intake_work_item # Update a work item in the intake queue. 3 params

Update a work item in the intake queue.

Name Type Required Description
data object required No description.
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
planemcp_update_label # Update the name or color of a label. 9 params

Update the name or color of a label.

Name Type Required Description
label_id string required UUID of the label. Get it from List Labels.
project_id string required UUID of the project. Get it from List Projects.
color string optional Hex color code for the item (e.g. #FF6B6B).
description string optional Optional description.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
name string optional Name or title of the item.
parent string optional UUID of the parent work item.
sort_order string optional Float value for manual sort ordering.
planemcp_update_milestone # Update the properties of a milestone. 6 params

Update the properties of a milestone.

Name Type Required Description
milestone_id string required UUID of the milestone. Get it from List Milestones.
project_id string required UUID of the project. Get it from List Projects.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
target_date string optional Target completion date in ISO 8601 format (YYYY-MM-DD).
title string optional Title of the page or item.
planemcp_update_module # Update the name, description, or other properties of a module. 11 params

Update the name, description, or other properties of a module.

Name Type Required Description
module_id string required UUID of the module. Get it from List Modules.
project_id string required UUID of the project. Get it from List Projects.
description string optional Optional description.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
lead string optional UUID of the lead member.
members string optional List of member user UUIDs.
name string optional Name or title of the item.
start_date string optional Start date in ISO 8601 format (YYYY-MM-DD).
status string optional Status filter for the query.
target_date string optional Target completion date in ISO 8601 format (YYYY-MM-DD).
planemcp_update_project # Update the name, settings, or other properties of a project. 23 params

Update the name, settings, or other properties of a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
archive_in string optional Number of days after which completed cycles are archived.
close_in string optional Number of days after which completed cycles are closed.
cover_image string optional URL of the cover image.
cycle_view string optional Whether to show the cycle view.
default_assignee string optional UUID of the default assignee for new work items.
default_state string optional UUID of the default state for the project.
description string optional Optional description.
emoji string optional Emoji icon for the item.
estimate string optional Estimation method for the project.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
guest_view_all_features string optional Whether guests can view all features.
identifier string optional Workspace slug identifier.
intake_view string optional Whether to show the intake view.
is_issue_type_enabled string optional Whether work item types are enabled for the project.
is_time_tracking_enabled string optional Whether time tracking is enabled for the project.
issue_views_view string optional Whether to show issue views.
module_view string optional Whether to show the module view.
name string optional Name or title of the item.
page_view string optional Whether to show the page view.
project_lead string optional UUID of the project lead member.
timezone string optional IANA timezone name (e.g. America/New_York).
planemcp_update_project_features # Enable or disable feature flags for a project. 8 params

Enable or disable feature flags for a project.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
cycles string optional Whether to enable cycles for the project.
epics string optional Whether to enable epics for the project.
intakes string optional Whether to enable intake for the project.
modules string optional Whether to enable modules for the project.
pages string optional Whether to enable pages for the project.
views string optional Whether to enable views for the project.
work_item_types string optional Whether to enable work item types.
planemcp_update_state # Update the name, color, or group of a workflow state. 11 params

Update the name, color, or group of a workflow state.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
state_id string required UUID of the state. Get it from List States.
color string optional Hex color code for the item (e.g. #FF6B6B).
default string optional Whether this is the default item.
description string optional Optional description.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
group string optional Group identifier.
is_triage string optional Whether this is a triage intake.
name string optional Name or title of the item.
sequence string optional Sequence number for ordering.
planemcp_update_work_item # Update the properties of an existing work item. 20 params

Update the properties of an existing work item.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
assignees string optional List of user UUIDs to assign to the work item.
description_html string optional HTML-formatted description of the work item.
description_stripped string optional Plain text description with HTML tags removed.
estimate_point string optional Estimation point value.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
is_draft string optional If true, saves the item as a draft.
labels string optional List of label UUIDs to attach to the work item.
name string optional Name or title of the item.
parent string optional UUID of the parent work item.
point string optional Story point value for the work item.
priority string optional Priority level. Accepted values: urgent, high, medium, low, none.
sort_order string optional Float value for manual sort ordering.
start_date string optional Start date in ISO 8601 format (YYYY-MM-DD).
state string optional UUID of the workflow state to assign.
target_date string optional Target completion date in ISO 8601 format (YYYY-MM-DD).
type string optional Type identifier for the item.
type_id string optional UUID of the work item type.
planemcp_update_work_item_comment # Edit the content of a comment on a work item. 8 params

Edit the content of a comment on a work item.

Name Type Required Description
comment_id string required UUID of the comment.
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
access string optional Access level (0 = secret, 1 = public).
comment_html string optional HTML content of the comment.
comment_json string optional No description.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
planemcp_update_work_item_property # Update the definition of a custom work item property. 15 params

Update the definition of a custom work item property.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
type_id string required UUID of the work item type.
work_item_property_id string required UUID of the custom work item property.
default_value string optional Default selected option values for the property.
description string optional Optional description.
display_name string optional Display label for the custom property.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
is_active string optional Whether this item is active.
is_multi string optional Whether the property allows multiple values.
is_required string optional Whether the property is required.
property_type string optional Data type of the custom property. Accepted values: text, number, boolean, datetime, option, relation.
relation_type string optional Type of work item relation. Accepted values: blocked_by, blocking, duplicate_of, duplicate.
settings string optional No description.
validation_rules string optional No description.
planemcp_update_work_item_type # Update the name or icon of a custom work item type. 9 params

Update the name or icon of a custom work item type.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_type_id string required UUID of the work item type.
description string optional Optional description.
external_id string optional Identifier in an external system.
external_source string optional Name of the external system (e.g. github).
is_active string optional Whether this item is active.
is_epic string optional Whether this work item is an epic.
name string optional Name or title of the item.
project_ids string optional List of project UUIDs to filter by.
planemcp_update_work_log # Update a work log entry on a work item. 5 params

Update a work log entry on a work item.

Name Type Required Description
project_id string required UUID of the project. Get it from List Projects.
work_item_id string required UUID of the work item.
work_log_id string required UUID of the work log entry.
description string optional Optional description.
duration string optional Duration in minutes.
planemcp_update_workspace_features # Enable or disable feature flags for the workspace. 6 params

Enable or disable feature flags for the workspace.

Name Type Required Description
customers string required Whether to enable the customers feature.
initiatives string required Whether to enable initiatives for the workspace.
pi string required Whether to enable PI planning.
project_grouping string required Whether to enable project grouping.
teams string required Whether to enable the teams feature.
wiki string required Whether to enable wiki pages.