Shortcut MCP server

Read from the package source without running it. The installed server may list more.

• create_categorywrite action

  Create a new Category in Shortcut for organizing Milestones or Objectives. Categories help structure and group related work items by type.

• create_documentwrite action

  Creates a new document with the specified title and content. Supports both markdown and HTML content formats via the content_format parameter.

• create_epicwrite action

  Create a new Epic in Shortcut. An Epic is a large body of work that can be broken down into Stories and related to Objectives and Groups.

• create_epic_commentwrite action

  Add a threaded comment to an Epic. The comment can be authored by the API token holder or another team member, and optionally linked to an external system via an external ID.

• create_epic_healthwrite action

  Create a new health status record for an Epic to track its current state. This allows you to document whether the Epic is progressing as planned, facing risks, or has encountered issues.

• create_groupwrite action

  Create a new group with members and workflows. Groups can be used to organize and manage collections of members and their associated workflows.

• create_iterationwrite action

  Create a new iteration (sprint or planning cycle) with a specified name, date range, and optional description. Optionally add groups as followers to the iteration.

• create_labelwrite action

  Create a new label in Shortcut to organize and categorize work items. Labels help teams tag and filter issues, stories, and other work across projects.

• create_linked_filewrite action

  Create a new linked file in Shortcut that references an external file from an integrated service like Google Drive, Dropbox, Box, OneDrive, or a direct URL. Optionally associate the file with a specific story.

• create_milestonewrite action

  Create a new Milestone in Shortcut. Note: This operation is deprecated; use create_objective for new implementations.

• create_objectivewrite action

  Create a new Objective in Shortcut to define goals and track progress. Objectives can be organized with categories and include detailed descriptions.

• create_projectwrite action

  Creates a new Shortcut project within a specified team. The project name is required, and you can optionally configure iteration length, description, start date, abbreviation, and external identifiers.

• create_reply_to_epic_commentwrite action

  Create a nested reply to an existing Epic Comment. This allows you to add threaded discussion to Epic Comments within an Epic.

• delete_categorywrite action

  Permanently delete a category by its unique identifier. This operation removes the category and cannot be undone.

• delete_custom_fieldwrite action

  Permanently delete a custom field by its unique identifier. This operation removes the custom field and all associated data.

• delete_docwrite action

  Permanently deletes a Doc and all its associated data. Requires admin access to the document. Connected clients will be notified of the deletion via SSE events.

• delete_epicwrite action

  Permanently delete an Epic by its unique identifier. This operation removes the Epic and cannot be undone.

• delete_epic_commentwrite action

  Permanently delete a comment from an epic. This action cannot be undone.

• delete_filewrite action

  Permanently delete a previously uploaded file by its unique identifier. This action cannot be undone.

• delete_iterationwrite action

  Permanently delete an iteration by its public ID. This action cannot be undone and will remove the iteration and all associated data.

• delete_labelwrite action

  Permanently delete a label by its unique identifier. This operation removes the label and cannot be undone.

• delete_linked_filewrite action

  Permanently delete a previously attached linked file by its unique identifier. This operation removes the file association and cannot be undone.

• delete_milestonewrite action

  Delete a milestone by its public ID. Note: This operation is deprecated; use delete_objective instead for new implementations.

• delete_objectivewrite action

  Permanently delete an Objective by its public ID. This action cannot be undone.

• delete_projectwrite action

  Permanently delete a project. Projects can only be deleted if all associated stories have been moved or deleted; attempting to delete a project with remaining stories will result in a 422 error.

• delete_webhook_integrationwrite action

  Permanently delete a webhook integration by its public identifier. This action cannot be undone and will remove all associated webhook configurations.

• get_category

  Retrieve detailed information about a specific category using its unique identifier. Returns the category's properties and metadata.

• get_current_member

  Retrieves detailed information about the authenticated member, including profile data and account settings.

• get_custom_field

  Retrieve a specific custom field by its unique identifier. Returns the complete configuration and metadata for the custom field.

• get_doc

  Retrieve a Doc by its public ID, including its full content. Optionally request HTML-formatted content using the content_format query parameter.

• get_entity_template

  Retrieve detailed information about a specific entity template using its unique identifier. This operation returns the complete configuration and metadata for the requested entity template.

• get_epic

  Retrieve detailed information about a specific Epic by its unique identifier. Returns the Epic's properties and metadata.

• get_epic_comment

  Retrieves detailed information about a specific comment on an Epic. Use this to fetch comment content, metadata, and other details by providing both the Epic ID and the Comment ID.

• get_epic_health

  Retrieve the current health status of a specified Epic. This provides insights into the Epic's overall condition and progress.

• get_file

  Retrieve detailed information about a specific uploaded file using its unique public identifier.

• get_group

  Retrieve detailed information about a specific group using its unique public identifier. Returns the group's metadata and configuration.

• get_iteration

  Retrieve detailed information about a specific iteration by its public ID. Use this to fetch iteration metadata, status, and associated data.

• get_key_result

  Retrieve detailed information about a specific Key Result by its unique identifier. Returns the Key Result's properties and current state.

• get_label

  Retrieve detailed information about a specific label by its unique identifier. Returns the label's properties and metadata.

• get_linked_file

  Retrieve detailed information about a specific linked file using its unique public identifier.

• get_member

  Retrieve detailed information about a specific member by their unique identifier. Optionally scope the lookup to a particular organization.

• get_milestone

  Retrieve detailed information about a specific milestone by its public ID. Note: This operation is deprecated; use get_objective instead for new implementations.

• get_objective

  Retrieve detailed information about a specific Objective by its public ID. Use this to fetch the full details of an Objective you want to inspect or reference.

• get_project

  Retrieve detailed information about a specific project using its unique public identifier. Returns comprehensive project metadata and configuration.

• get_repository

  Retrieve detailed information about a specific repository using its unique public identifier.

• get_webhook_integration

  Retrieve a specific webhook integration by its public identifier. Use this to fetch configuration and details for a webhook integration.

• link_document_to_epicwrite action

  Create a relationship between a Document and an Epic, associating the document with the specified epic for organizational and tracking purposes.

• list_categories

  Retrieve a complete list of all available categories with their attributes. Use this to discover category options for filtering, organizing, or referencing in other operations.

• list_custom_fields

  Retrieve all custom fields available in the system. This returns the complete list of custom field definitions that can be used across resources.

• list_document_epics

  Retrieve all Epics associated with a specific Document. Returns a collection of Epics linked to the Document identified by its public ID.

• list_documents

  Retrieve a list of all documents that the current user has read access to. Returns documents accessible based on the user's permissions.

• list_entity_templates

  Retrieve all entity templates available in the Workspace. Entity templates define the structure and configuration for entities within your workspace.

• list_epic_comments

  Retrieve all comments associated with a specific Epic. Returns a list of comment objects ordered by creation date.

• list_epic_documents

  Retrieve all documents associated with a specific Epic. Returns a collection of documents linked to the Epic for reference and collaboration.

• list_epic_health_history

  Retrieve the complete health status history for a specified Epic, ordered from most recent to oldest. Use this to track how an Epic's health has evolved over time.

• list_epic_stories

  Retrieve all stories associated with a specific epic. Optionally include story descriptions in the response.

• list_epics

  Retrieve a list of all Epics with their core attributes. Optionally include full descriptions for each Epic.

• list_epics_for_label

  Retrieve all Epics associated with a specific Label. Use this to view Epic-level work items grouped by a particular label.

• list_epics_for_milestone

  Retrieve all epics associated with a specific milestone. This operation is deprecated; use list_objective_epics instead for new implementations.

• list_epics_for_objective

  Retrieve all epics associated with a specific objective. Epics are returned as a collection within the objective.

• list_epics_paginated

  Retrieve a paginated list of Epics with optional descriptions. Use pagination parameters to control which results are returned and how many per page.

• list_files

  Retrieve a list of all uploaded files in the workspace. Returns metadata for each file available in the current workspace.

• list_group_stories

  Retrieve all Stories assigned to a specific Group with pagination support. Results are limited to a maximum of 1,000 stories by default.

• list_groups

  Retrieve a list of groups (teams) in Shortcut. Groups represent collections of users that can be associated with stories, epics, and iterations. Optionally filter by archived status.

• list_iteration_stories

  Retrieve all stories associated with a specific iteration. Optionally include story descriptions in the response.

• list_iterations

  Retrieve a list of all iterations. Iterations represent time-boxed periods used for organizing and tracking work in agile project management.

• list_labels

  Retrieve all labels available in the system with their complete attributes. Optionally request slim versions containing only essential label information.

• list_linked_files

  Retrieve a complete list of all linked files with their attributes. Use this to view all file associations in the system.

• list_milestones

  Retrieve a list of all milestones with their attributes. Note: This endpoint is deprecated; use list_objectives for new implementations.

• list_milestones_for_category

  Retrieve all milestones associated with a specific category. Returns a complete list of milestones within the given category.

• list_objectives

  Retrieve a complete list of all objectives with their associated attributes and metadata.

• list_objectives_for_category

  Retrieves all Objectives associated with a specific Category. Use this to view the complete list of objectives within a category.

• list_projects

  Retrieve a list of all projects with their complete attributes and metadata. Use this to discover available projects or build project directories.

• list_repositories

  Retrieve a complete list of all repositories with their attributes. Use this operation to discover available repositories and their metadata.

• list_stories

  Retrieve all stories in a project with their core attributes. Optionally include story descriptions in the response.

• list_stories_by_external_link

  Retrieve all stories associated with a given external link. Use this to find stories that reference or are linked to a specific URL.

• list_stories_by_label

  Retrieve all stories associated with a specific label. Optionally include story descriptions in the response.

• list_workspace_members

  Retrieve a list of members in the Workspace, with optional filtering by Organization and member status.

• remove_document_from_epicwrite action

  Remove the relationship between a Document and an Epic, unlinking them from each other.

• remove_productboard_from_epicwrite action

  Unlink a Productboard epic from an Epic, removing the association between the two resources.

• search_documents

  Search for documents by title with optional filtering by archive status, ownership, and follow status. Supports fuzzy matching on document titles and pagination of results.

• search_epics

  Search for epics using query operators and optional filters. Results support pagination via the `next` cursor to maintain stable ordering as the search index evolves.

• search_epics_and_stories

  Search for Epics and Stories using search operators and filters. Results are ranked and paginated; use the `next` value from previous responses to maintain stable ordering across pages.

• search_iterations

  Search for iterations using query operators and filters. Results are ordered by search ranking and can be paginated using the next cursor from previous responses to maintain stable ordering.

• update_categorywrite action

  Update a Category's name and/or archived status. Category names must be unique; attempting to use a name that already exists will result in an error.

• update_custom_fieldwrite action

  Update the definition of a custom field, including its name, description, enabled status, enum values, and icon. Enum values are ordered by their position in the collection; omit values to delete them, or include new values with only a 'value' property to create them inline.

• update_documentwrite action

  Update a document's title and/or content. Supports markdown or HTML input. Connected users receive real-time SSE notifications to refresh their view, while disconnected sessions trigger cache invalidation to ensure fresh content.

• update_epicwrite action

  Update an Epic's properties including name, description, dates, state, and relationships. Only the Epic ID is required; all other fields are optional and will only be updated if provided.

• update_epic_commentwrite action

  Update the text content of an existing threaded comment on an Epic. Allows modification of comment text while preserving the comment's identity and thread context.

• update_filewrite action

  Update the metadata properties of an uploaded file, including its name, description, and external identifier. The file content itself cannot be modified through this operation.

• update_groupwrite action

  Update an existing group's properties including name, description, icon, workflow settings, and membership. Allows archiving groups and modifying their configuration.

• update_healthwrite action

  Update the health status and description of an Epic. Modify the current health state and optional status text to reflect the Epic's current condition.

• update_iterationwrite action

  Update an existing iteration with new metadata such as name, description, dates, and group followers. Allows partial updates—only provided fields are modified.

• update_key_resultwrite action

  Update a Key Result's name, initial value, observed value, or target value. Supports numeric values (up to 2 decimal places) or boolean values for the observed metric.

• update_labelwrite action

  Update a label's name, description, or archived status. The label name must be unique within the system; attempting to use a name that already exists will result in an error.

• update_linked_filewrite action

  Update properties of a previously attached linked file, such as its name, description, associated story, or source URL. Supports files from multiple integration types including Google Drive, Dropbox, Box, OneDrive, and direct URLs.

• update_milestonewrite action

  Update properties of an existing milestone, including its name, description, archived status, and associated categories. Note: This operation is deprecated; use update_objective for new implementations.

• update_objectivewrite action

  Update an Objective's properties including its name, description, archived status, and associated categories. Use this operation to modify any aspect of an existing Objective.

• update_projectwrite action

  Update project properties such as name, description, team assignment, and thermometer settings. Changes are applied immediately to the specified project.

• upload_fileswrite action

  Upload one or more files to the system, optionally associating them with a specific story. Files are submitted using multipart/form-data encoding with each file assigned to a separate form field.

• Code scan5 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenancelast push 138 days ago8/15
• Maintainer identityregistry namespace matches repository owner7/10

Safety score

80/100

higher than 60% of 48,255 servers

Tools

100

the typical server has 7

Tools that change things

45%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

31

more than 92% of 28,688 servers

Downloads a week

153

more than 71% of 12,191 servers with a package

Shortcut: common questions

Is Shortcut MCP server safe?

Mostly: it is graded B (80/100). Read the Shortcut safety report

How do I install Shortcut?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Shortcut need an API key?

Not as far as the registry entry and our scan can tell: no credentials are declared or required.

Is Shortcut maintained?

The last commit was 176 days ago (2026-05-12). The latest release is v1.0.2.

How does Shortcut compare with other MCP servers?

safety score 80/100 (higher than 60% of 48,255 servers); tools 100 (the typical server has 7); tools that change things 45% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.