Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Plane MCP connector

OAuth 2.1/DCRProject 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.

NameTypeRequiredDescription
cycle_idstringrequiredUUID of the cycle. Get it from List Cycles.
issue_idsarrayrequiredList of work item UUIDs to add.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
issue_idsarrayrequiredList of work item UUIDs to add.
milestone_idstringrequiredUUID of the milestone. Get it from List Milestones.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
issue_idsarrayrequiredList of work item UUIDs to add.
module_idstringrequiredUUID of the module. Get it from List Modules.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
cycle_idstringrequiredUUID of the cycle. Get it from List Cycles.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
module_idstringrequiredUUID of the module. Get it from List Modules.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
namestringrequiredName or title of the item.
owned_bystringrequiredUUID of the member who owns this item.
project_idstringrequiredUUID of the project. Get it from List Projects.
descriptionstringoptionalOptional description.
end_datestringoptionalEnd date in ISO 8601 format (YYYY-MM-DD).
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
start_datestringoptionalStart date in ISO 8601 format (YYYY-MM-DD).
timezonestringoptionalIANA 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.

NameTypeRequiredDescription
namestringrequiredName or title of the item.
project_idstringrequiredUUID of the project. Get it from List Projects.
assigneesstringoptionalList of user UUIDs to assign to the work item.
description_htmlstringoptionalHTML-formatted description of the work item.
description_strippedstringoptionalPlain text description with HTML tags removed.
estimate_pointstringoptionalEstimation point value.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
is_draftstringoptionalIf true, saves the item as a draft.
labelsstringoptionalList of label UUIDs to attach to the work item.
parentstringoptionalUUID of the parent work item.
pointstringoptionalStory point value for the work item.
prioritystringoptionalPriority level. Accepted values: urgent, high, medium, low, none.
sort_orderstringoptionalFloat value for manual sort ordering.
start_datestringoptionalStart date in ISO 8601 format (YYYY-MM-DD).
statestringoptionalUUID of the workflow state to assign.
target_datestringoptionalTarget 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.

NameTypeRequiredDescription
namestringrequiredName or title of the item.
description_htmlstringoptionalHTML-formatted description of the work item.
end_datestringoptionalEnd date in ISO 8601 format (YYYY-MM-DD).
leadstringoptionalUUID of the lead member.
logo_propsstringoptionalNo description.
start_datestringoptionalStart date in ISO 8601 format (YYYY-MM-DD).
statestringoptionalUUID 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.

NameTypeRequiredDescription
dataobjectrequiredNo description.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
namestringrequiredName or title of the item.
project_idstringrequiredUUID of the project. Get it from List Projects.
colorstringoptionalHex color code for the item (e.g. #FF6B6B).
descriptionstringoptionalOptional description.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
parentstringoptionalUUID of the parent work item.
sort_orderstringoptionalFloat value for manual sort ordering.
planemcp_create_milestone#Create a new milestone in a project.5 params

Create a new milestone in a project.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
titlestringrequiredTitle of the page or item.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
target_datestringoptionalTarget 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.

NameTypeRequiredDescription
namestringrequiredName or title of the item.
project_idstringrequiredUUID of the project. Get it from List Projects.
descriptionstringoptionalOptional description.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
leadstringoptionalUUID of the lead member.
membersstringoptionalList of member user UUIDs.
start_datestringoptionalStart date in ISO 8601 format (YYYY-MM-DD).
statusstringoptionalStatus filter for the query.
target_datestringoptionalTarget 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.

NameTypeRequiredDescription
identifierstringrequiredWorkspace slug identifier.
namestringrequiredName or title of the item.
archive_instringoptionalNumber of days after which completed cycles are archived.
close_instringoptionalNumber of days after which completed cycles are closed.
cover_imagestringoptionalURL of the cover image.
cycle_viewstringoptionalWhether to show the cycle view.
default_assigneestringoptionalUUID of the default assignee for new work items.
descriptionstringoptionalOptional description.
emojistringoptionalEmoji icon for the item.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
guest_view_all_featuresstringoptionalWhether guests can view all features.
intake_viewstringoptionalWhether to show the intake view.
is_issue_type_enabledstringoptionalWhether work item types are enabled for the project.
issue_views_viewstringoptionalWhether to show issue views.
module_viewstringoptionalWhether to show the module view.
page_viewstringoptionalWhether to show the page view.
project_leadstringoptionalUUID of the project lead member.
timezonestringoptionalIANA 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.

NameTypeRequiredDescription
description_htmlstringrequiredHTML-formatted description of the work item.
namestringrequiredName or title of the item.
project_idstringrequiredUUID of the project. Get it from List Projects.
accessstringoptionalAccess level (0 = secret, 1 = public).
archived_atstringoptionalTimestamp when the item was archived.
colorstringoptionalHex color code for the item (e.g. #FF6B6B).
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
is_lockedstringoptionalWhether the page is locked for editing.
logo_propsstringoptionalNo description.
view_propsstringoptionalNo description.
planemcp_create_state#Create a new workflow state in a project.10 params

Create a new workflow state in a project.

NameTypeRequiredDescription
colorstringrequiredHex color code for the item (e.g. #FF6B6B).
namestringrequiredName or title of the item.
project_idstringrequiredUUID of the project. Get it from List Projects.
defaultstringoptionalWhether this is the default item.
descriptionstringoptionalOptional description.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
groupstringoptionalGroup identifier.
is_triagestringoptionalWhether this is a triage intake.
sequencestringoptionalSequence 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.

NameTypeRequiredDescription
namestringrequiredName or title of the item.
project_idstringrequiredUUID of the project. Get it from List Projects.
assigneesstringoptionalList of user UUIDs to assign to the work item.
description_htmlstringoptionalHTML-formatted description of the work item.
description_strippedstringoptionalPlain text description with HTML tags removed.
estimate_pointstringoptionalEstimation point value.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
is_draftstringoptionalIf true, saves the item as a draft.
labelsstringoptionalList of label UUIDs to attach to the work item.
parentstringoptionalUUID of the parent work item.
pointstringoptionalStory point value for the work item.
prioritystringoptionalPriority level. Accepted values: urgent, high, medium, low, none.
sort_orderstringoptionalFloat value for manual sort ordering.
start_datestringoptionalStart date in ISO 8601 format (YYYY-MM-DD).
statestringoptionalUUID of the workflow state to assign.
target_datestringoptionalTarget completion date in ISO 8601 format (YYYY-MM-DD).
typestringoptionalType identifier for the item.
type_idstringoptionalUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID of the work item.
accessstringoptionalAccess level (0 = secret, 1 = public).
comment_htmlstringoptionalHTML content of the comment.
comment_jsonstringoptionalNo description.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName 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.

NameTypeRequiredDescription
display_namestringrequiredDisplay label for the custom property.
project_idstringrequiredUUID of the project. Get it from List Projects.
property_typestringrequiredData type of the custom property. Accepted values: text, number, boolean, datetime, option, relation.
type_idstringrequiredUUID of the work item type.
default_valuestringoptionalDefault selected option values for the property.
descriptionstringoptionalOptional description.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
is_activestringoptionalWhether this item is active.
is_multistringoptionalWhether the property allows multiple values.
is_requiredstringoptionalWhether the property is required.
optionsstringoptionalNo description.
relation_typestringoptionalType of work item relation. Accepted values: blocked_by, blocking, duplicate_of, duplicate.
settingsstringoptionalNo description.
validation_rulesstringoptionalNo 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).

NameTypeRequiredDescription
issuesarrayrequiredList of work item UUIDs to create relations for.
project_idstringrequiredUUID of the project. Get it from List Projects.
relation_typestringrequiredType of work item relation. Accepted values: blocked_by, blocking, duplicate_of, duplicate.
work_item_idstringrequiredUUID 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.

NameTypeRequiredDescription
namestringrequiredName or title of the item.
project_idstringrequiredUUID of the project. Get it from List Projects.
descriptionstringoptionalOptional description.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
is_activestringoptionalWhether this item is active.
is_epicstringoptionalWhether this work item is an epic.
project_idsstringoptionalList 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID of the work item.
descriptionstringoptionalOptional description.
durationstringoptionalDuration in minutes.
planemcp_create_workspace_page#Create a new page at the workspace level.10 params

Create a new page at the workspace level.

NameTypeRequiredDescription
description_htmlstringrequiredHTML-formatted description of the work item.
namestringrequiredName or title of the item.
accessstringoptionalAccess level (0 = secret, 1 = public).
archived_atstringoptionalTimestamp when the item was archived.
colorstringoptionalHex color code for the item (e.g. #FF6B6B).
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
is_lockedstringoptionalWhether the page is locked for editing.
logo_propsstringoptionalNo description.
view_propsstringoptionalNo description.
planemcp_delete_cycle#Permanently delete a cycle from a project.2 params

Permanently delete a cycle from a project.

NameTypeRequiredDescription
cycle_idstringrequiredUUID of the cycle. Get it from List Cycles.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
epic_idstringrequiredUUID of the epic. Get it from List Epics.
project_idstringrequiredUUID of the project. Get it from List Projects.
planemcp_delete_initiative#Permanently delete a workspace initiative.1 param

Permanently delete a workspace initiative.

NameTypeRequiredDescription
initiative_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID of the work item.
planemcp_delete_label#Permanently delete a label from a project.2 params

Permanently delete a label from a project.

NameTypeRequiredDescription
label_idstringrequiredUUID of the label. Get it from List Labels.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
milestone_idstringrequiredUUID of the milestone. Get it from List Milestones.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
module_idstringrequiredUUID of the module. Get it from List Modules.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
state_idstringrequiredUUID of the state. Get it from List States.
planemcp_delete_work_item#Permanently delete a work item.2 params

Permanently delete a work item.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID 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.

NameTypeRequiredDescription
comment_idstringrequiredUUID of the comment.
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
type_idstringrequiredUUID of the work item type.
work_item_property_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_type_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID of the work item.
work_log_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
paramsstringoptionalNo 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.

NameTypeRequiredDescription
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
paramsstringoptionalNo description.
planemcp_list_archived_modules#Retrieve all archived modules in a project.2 params

Retrieve all archived modules in a project.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
paramsstringoptionalNo description.
planemcp_list_cycle_work_items#Retrieve all work items in a cycle.3 params

Retrieve all work items in a cycle.

NameTypeRequiredDescription
cycle_idstringrequiredUUID of the cycle. Get it from List Cycles.
project_idstringrequiredUUID of the project. Get it from List Projects.
paramsstringoptionalNo description.
planemcp_list_cycles#Retrieve all cycles (sprints) in a project.2 params

Retrieve all cycles (sprints) in a project.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
paramsstringoptionalNo description.
planemcp_list_epics#Retrieve all epics in a project.3 params

Retrieve all epics in a project.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
cursorstringoptionalPagination cursor from the previous response.
per_pagestringoptionalNumber of items per page.
planemcp_list_initiatives#Retrieve all initiatives in the workspace.1 param

Retrieve all initiatives in the workspace.

NameTypeRequiredDescription
paramsstringoptionalNo 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
paramsstringoptionalNo description.
planemcp_list_labels#Retrieve all labels in a project.2 params

Retrieve all labels in a project.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
paramsstringoptionalNo description.
planemcp_list_milestone_work_items#Retrieve all work items assigned to a milestone.3 params

Retrieve all work items assigned to a milestone.

NameTypeRequiredDescription
milestone_idstringrequiredUUID of the milestone. Get it from List Milestones.
project_idstringrequiredUUID of the project. Get it from List Projects.
paramsstringoptionalNo description.
planemcp_list_milestones#Retrieve all milestones in a project.2 params

Retrieve all milestones in a project.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
paramsstringoptionalNo description.
planemcp_list_module_work_items#Retrieve all work items in a module.3 params

Retrieve all work items in a module.

NameTypeRequiredDescription
module_idstringrequiredUUID of the module. Get it from List Modules.
project_idstringrequiredUUID of the project. Get it from List Projects.
paramsstringoptionalNo description.
planemcp_list_modules#Retrieve all modules in a project.2 params

Retrieve all modules in a project.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
paramsstringoptionalNo description.
planemcp_list_projects#Retrieve all projects in the workspace.5 params

Retrieve all projects in the workspace.

NameTypeRequiredDescription
cursorstringoptionalPagination cursor from the previous response.
expandstringoptionalComma-separated list of fields to expand in the response.
fieldsstringoptionalComma-separated list of fields to include in the response.
order_bystringoptionalField to sort results by (e.g. -created_at for descending).
per_pagestringoptionalNumber of items per page.
planemcp_list_states#Retrieve all workflow states in a project.2 params

Retrieve all workflow states in a project.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
paramsstringoptionalNo description.
planemcp_list_work_item_activities#Retrieve the activity history for a work item.3 params

Retrieve the activity history for a work item.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID of the work item.
paramsstringoptionalNo description.
planemcp_list_work_item_comments#Retrieve all comments on a work item.3 params

Retrieve all comments on a work item.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID of the work item.
paramsstringoptionalNo description.
planemcp_list_work_item_properties#Retrieve all custom properties defined in a project.3 params

Retrieve all custom properties defined in a project.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
type_idstringrequiredUUID of the work item type.
paramsstringoptionalNo description.
planemcp_list_work_item_relations#Retrieve all relations for a work item.2 params

Retrieve all relations for a work item.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
paramsstringoptionalNo 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.

NameTypeRequiredDescription
assignee_idsstringoptionalList of user UUIDs to assign.
created_by_idsstringoptionalList of user UUIDs to filter by creator.
cursorstringoptionalPagination cursor from the previous response.
cycle_idsstringoptionalList of cycle UUIDs.
expandstringoptionalComma-separated list of fields to expand in the response.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
fieldsstringoptionalComma-separated list of fields to include in the response.
is_archivedstringoptionalWhether to include archived items.
label_idsstringoptionalList of label UUIDs to attach.
limitstringoptionalMaximum number of items to return.
module_idsstringoptionalList of module UUIDs to add the work item to.
order_bystringoptionalField to sort results by (e.g. -created_at for descending).
per_pagestringoptionalNumber of items per page.
prioritiesstringoptionalList of priority values to filter by.
project_idstringoptionalUUID of the project. Get it from List Projects.
querystringoptionalText query to search work items by name or description.
state_groupsstringoptionalList of state groups to filter by (e.g. started, unstarted).
state_idsstringoptionalList of state UUIDs to filter by.
type_idsstringoptionalList of work item type UUIDs to filter by.
workspace_searchbooleanoptionalIf 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID of the work item.
paramsstringoptionalNo description.
planemcp_remove_work_item_from_cycle#Remove a work item from a cycle.3 params

Remove a work item from a cycle.

NameTypeRequiredDescription
cycle_idstringrequiredUUID of the cycle. Get it from List Cycles.
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID 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.

NameTypeRequiredDescription
module_idstringrequiredUUID of the module. Get it from List Modules.
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
related_issuestringrequiredUUID of the related work item.
work_item_idstringrequiredUUID 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.

NameTypeRequiredDescription
issue_idsarrayrequiredList of work item UUIDs to add.
milestone_idstringrequiredUUID of the milestone. Get it from List Milestones.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
cycle_idstringrequiredUUID of the cycle. Get it from List Cycles.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
epic_idstringrequiredUUID of the epic. Get it from List Epics.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
initiative_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID of the work item.
paramsstringoptionalNo description.
planemcp_retrieve_label#Retrieve details of a specific label by its ID.2 params

Retrieve details of a specific label by its ID.

NameTypeRequiredDescription
label_idstringrequiredUUID of the label. Get it from List Labels.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
milestone_idstringrequiredUUID of the milestone. Get it from List Milestones.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
module_idstringrequiredUUID of the module. Get it from List Modules.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
page_idstringrequiredUUID of the page.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
state_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID of the work item.
expandstringoptionalComma-separated list of fields to expand in the response.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
fieldsstringoptionalComma-separated list of fields to include in the response.
order_bystringoptionalField 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.

NameTypeRequiredDescription
activity_idstringrequiredUUID of the activity entry.
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID 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).

NameTypeRequiredDescription
issue_identifierintegerrequiredNumeric sequence identifier of the work item within the project.
project_identifierstringrequiredShort project identifier prefix (e.g. PRJ).
expandstringoptionalComma-separated list of fields to expand in the response.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
fieldsstringoptionalComma-separated list of fields to include in the response.
order_bystringoptionalField 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.

NameTypeRequiredDescription
comment_idstringrequiredUUID of the comment.
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
type_idstringrequiredUUID of the work item type.
work_item_property_idstringrequiredUUID 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_type_idstringrequiredUUID 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.

NameTypeRequiredDescription
page_idstringrequiredUUID 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.

NameTypeRequiredDescription
querystringrequiredText query to search work items by name or description.
expandstringoptionalComma-separated list of fields to expand in the response.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
fieldsstringoptionalComma-separated list of fields to include in the response.
order_bystringoptionalField 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.

NameTypeRequiredDescription
cycle_idstringrequiredUUID of the cycle. Get it from List Cycles.
new_cycle_idstringrequiredUUID of the cycle to transfer work items to.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
cycle_idstringrequiredUUID of the cycle. Get it from List Cycles.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
module_idstringrequiredUUID of the module. Get it from List Modules.
project_idstringrequiredUUID 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.

NameTypeRequiredDescription
cycle_idstringrequiredUUID of the cycle. Get it from List Cycles.
project_idstringrequiredUUID of the project. Get it from List Projects.
descriptionstringoptionalOptional description.
end_datestringoptionalEnd date in ISO 8601 format (YYYY-MM-DD).
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
namestringoptionalName or title of the item.
owned_bystringoptionalUUID of the member who owns this item.
start_datestringoptionalStart date in ISO 8601 format (YYYY-MM-DD).
timezonestringoptionalIANA 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.

NameTypeRequiredDescription
epic_idstringrequiredUUID of the epic. Get it from List Epics.
project_idstringrequiredUUID of the project. Get it from List Projects.
assigneesstringoptionalList of user UUIDs to assign to the work item.
description_htmlstringoptionalHTML-formatted description of the work item.
description_strippedstringoptionalPlain text description with HTML tags removed.
estimate_pointstringoptionalEstimation point value.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
is_draftstringoptionalIf true, saves the item as a draft.
labelsstringoptionalList of label UUIDs to attach to the work item.
namestringoptionalName or title of the item.
pointstringoptionalStory point value for the work item.
prioritystringoptionalPriority level. Accepted values: urgent, high, medium, low, none.
sort_orderstringoptionalFloat value for manual sort ordering.
start_datestringoptionalStart date in ISO 8601 format (YYYY-MM-DD).
statestringoptionalUUID of the workflow state to assign.
target_datestringoptionalTarget 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.

NameTypeRequiredDescription
initiative_idstringrequiredUUID of the initiative. Get it from List Initiatives.
description_htmlstringoptionalHTML-formatted description of the work item.
end_datestringoptionalEnd date in ISO 8601 format (YYYY-MM-DD).
leadstringoptionalUUID of the lead member.
logo_propsstringoptionalNo description.
namestringoptionalName or title of the item.
start_datestringoptionalStart date in ISO 8601 format (YYYY-MM-DD).
statestringoptionalUUID 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.

NameTypeRequiredDescription
dataobjectrequiredNo description.
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID 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.

NameTypeRequiredDescription
label_idstringrequiredUUID of the label. Get it from List Labels.
project_idstringrequiredUUID of the project. Get it from List Projects.
colorstringoptionalHex color code for the item (e.g. #FF6B6B).
descriptionstringoptionalOptional description.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
namestringoptionalName or title of the item.
parentstringoptionalUUID of the parent work item.
sort_orderstringoptionalFloat value for manual sort ordering.
planemcp_update_milestone#Update the properties of a milestone.6 params

Update the properties of a milestone.

NameTypeRequiredDescription
milestone_idstringrequiredUUID of the milestone. Get it from List Milestones.
project_idstringrequiredUUID of the project. Get it from List Projects.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
target_datestringoptionalTarget completion date in ISO 8601 format (YYYY-MM-DD).
titlestringoptionalTitle 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.

NameTypeRequiredDescription
module_idstringrequiredUUID of the module. Get it from List Modules.
project_idstringrequiredUUID of the project. Get it from List Projects.
descriptionstringoptionalOptional description.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
leadstringoptionalUUID of the lead member.
membersstringoptionalList of member user UUIDs.
namestringoptionalName or title of the item.
start_datestringoptionalStart date in ISO 8601 format (YYYY-MM-DD).
statusstringoptionalStatus filter for the query.
target_datestringoptionalTarget 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
archive_instringoptionalNumber of days after which completed cycles are archived.
close_instringoptionalNumber of days after which completed cycles are closed.
cover_imagestringoptionalURL of the cover image.
cycle_viewstringoptionalWhether to show the cycle view.
default_assigneestringoptionalUUID of the default assignee for new work items.
default_statestringoptionalUUID of the default state for the project.
descriptionstringoptionalOptional description.
emojistringoptionalEmoji icon for the item.
estimatestringoptionalEstimation method for the project.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
guest_view_all_featuresstringoptionalWhether guests can view all features.
identifierstringoptionalWorkspace slug identifier.
intake_viewstringoptionalWhether to show the intake view.
is_issue_type_enabledstringoptionalWhether work item types are enabled for the project.
is_time_tracking_enabledstringoptionalWhether time tracking is enabled for the project.
issue_views_viewstringoptionalWhether to show issue views.
module_viewstringoptionalWhether to show the module view.
namestringoptionalName or title of the item.
page_viewstringoptionalWhether to show the page view.
project_leadstringoptionalUUID of the project lead member.
timezonestringoptionalIANA 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
cyclesstringoptionalWhether to enable cycles for the project.
epicsstringoptionalWhether to enable epics for the project.
intakesstringoptionalWhether to enable intake for the project.
modulesstringoptionalWhether to enable modules for the project.
pagesstringoptionalWhether to enable pages for the project.
viewsstringoptionalWhether to enable views for the project.
work_item_typesstringoptionalWhether 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
state_idstringrequiredUUID of the state. Get it from List States.
colorstringoptionalHex color code for the item (e.g. #FF6B6B).
defaultstringoptionalWhether this is the default item.
descriptionstringoptionalOptional description.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
groupstringoptionalGroup identifier.
is_triagestringoptionalWhether this is a triage intake.
namestringoptionalName or title of the item.
sequencestringoptionalSequence 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID of the work item.
assigneesstringoptionalList of user UUIDs to assign to the work item.
description_htmlstringoptionalHTML-formatted description of the work item.
description_strippedstringoptionalPlain text description with HTML tags removed.
estimate_pointstringoptionalEstimation point value.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
is_draftstringoptionalIf true, saves the item as a draft.
labelsstringoptionalList of label UUIDs to attach to the work item.
namestringoptionalName or title of the item.
parentstringoptionalUUID of the parent work item.
pointstringoptionalStory point value for the work item.
prioritystringoptionalPriority level. Accepted values: urgent, high, medium, low, none.
sort_orderstringoptionalFloat value for manual sort ordering.
start_datestringoptionalStart date in ISO 8601 format (YYYY-MM-DD).
statestringoptionalUUID of the workflow state to assign.
target_datestringoptionalTarget completion date in ISO 8601 format (YYYY-MM-DD).
typestringoptionalType identifier for the item.
type_idstringoptionalUUID 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.

NameTypeRequiredDescription
comment_idstringrequiredUUID of the comment.
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID of the work item.
accessstringoptionalAccess level (0 = secret, 1 = public).
comment_htmlstringoptionalHTML content of the comment.
comment_jsonstringoptionalNo description.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
type_idstringrequiredUUID of the work item type.
work_item_property_idstringrequiredUUID of the custom work item property.
default_valuestringoptionalDefault selected option values for the property.
descriptionstringoptionalOptional description.
display_namestringoptionalDisplay label for the custom property.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
is_activestringoptionalWhether this item is active.
is_multistringoptionalWhether the property allows multiple values.
is_requiredstringoptionalWhether the property is required.
property_typestringoptionalData type of the custom property. Accepted values: text, number, boolean, datetime, option, relation.
relation_typestringoptionalType of work item relation. Accepted values: blocked_by, blocking, duplicate_of, duplicate.
settingsstringoptionalNo description.
validation_rulesstringoptionalNo 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_type_idstringrequiredUUID of the work item type.
descriptionstringoptionalOptional description.
external_idstringoptionalIdentifier in an external system.
external_sourcestringoptionalName of the external system (e.g. github).
is_activestringoptionalWhether this item is active.
is_epicstringoptionalWhether this work item is an epic.
namestringoptionalName or title of the item.
project_idsstringoptionalList 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.

NameTypeRequiredDescription
project_idstringrequiredUUID of the project. Get it from List Projects.
work_item_idstringrequiredUUID of the work item.
work_log_idstringrequiredUUID of the work log entry.
descriptionstringoptionalOptional description.
durationstringoptionalDuration in minutes.
planemcp_update_workspace_features#Enable or disable feature flags for the workspace.6 params

Enable or disable feature flags for the workspace.

NameTypeRequiredDescription
customersstringrequiredWhether to enable the customers feature.
initiativesstringrequiredWhether to enable initiatives for the workspace.
pistringrequiredWhether to enable PI planning.
project_groupingstringrequiredWhether to enable project grouping.
teamsstringrequiredWhether to enable the teams feature.
wikistringrequiredWhether to enable wiki pages.