Skip to main content
Glama
ptamb3

Shortcut MCP Server

by ptamb3

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
SHORTCUT_API_TOKENYesYour Shortcut API token. Generate one at Settings → API Tokens in your Shortcut workspace.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_storiesC

Search Shortcut stories with Shortcut query syntax.

get_storyB

Get a Shortcut story by numeric story ID.

create_storyC

Create a new Shortcut story in a project.

update_storyC

Update fields on an existing Shortcut story.

transition_story_stateB

Move a story to a new workflow state using either state ID or state name.

list_story_commentsB

List comments for a Shortcut story.

create_story_commentC

Create a comment on a Shortcut story.

list_workflowsB

List all workflows in your Shortcut workspace.

list_epicsC

List epics in your Shortcut workspace.

get_epicB

Get a Shortcut epic by numeric epic ID.

create_epicC

Create a new epic in Shortcut.

update_epicC

Update fields on an existing Shortcut epic.

list_projectsC

List projects in your Shortcut workspace.

list_membersB

List members in your Shortcut workspace.

list_milestonesC

List milestones in your Shortcut workspace.

create_milestoneC

Create a new milestone in Shortcut.

update_milestoneC

Update fields on an existing Shortcut milestone.

delete_storyA

Permanently delete a Shortcut story by ID. This is IRREVERSIBLE. Requires both confirm='CONFIRM_WRITE' and confirm_delete=true.

delete_epicA

Permanently delete a Shortcut epic by ID. This is IRREVERSIBLE. Requires both confirm='CONFIRM_WRITE' and confirm_delete=true.

list_labelsC

List all labels in your Shortcut workspace.

list_iterationsC

List iterations (sprints) in your Shortcut workspace.

list_groupsB

List teams/groups in your Shortcut workspace.

list_custom_fieldsA

List all custom fields (e.g. Priority) and their possible values in your Shortcut workspace.

list_story_tasksB

List checklist tasks on a Shortcut story.

create_story_taskC

Add a checklist task to a Shortcut story.

update_story_taskB

Update a checklist task on a Shortcut story (e.g. mark complete).

create_story_linkC

Link two stories together (e.g. blocks, is blocked by, relates to, duplicates).

archive_storyA

Archive a Shortcut story. Requires confirm_archive=true and confirm='CONFIRM_WRITE'.

add_story_labelA

Add a label to a Shortcut story by providing the full set of label IDs.

remove_story_labelA

Remove a label from a Shortcut story. Provide the remaining label IDs after removal. Requires confirm='CONFIRM_WRITE'.

list_story_external_linksC

List external links attached to a Shortcut story.

list_epic_storiesA

List all stories belonging to a Shortcut epic.

archive_epicB

Archive a Shortcut epic. Requires confirm_archive=true and confirm='CONFIRM_WRITE'.

add_epic_labelB

Add a label to a Shortcut epic by providing the full set of label IDs.

create_iterationC

Create a new iteration (sprint) in Shortcut.

update_iterationC

Update fields on an existing Shortcut iteration.

get_iteration_storiesB

List all stories in a Shortcut iteration.

create_labelC

Create a new label in Shortcut.

update_labelC

Update a label in Shortcut.

delete_labelA

Permanently delete a Shortcut label. IRREVERSIBLE. Requires confirm_delete=true and confirm='CONFIRM_WRITE'.

update_story_commentC

Update the text of a comment on a Shortcut story.

delete_story_commentA

Permanently delete a comment on a Shortcut story. IRREVERSIBLE. Requires confirm_delete=true and confirm='CONFIRM_WRITE'.

create_projectC

Create a new project in Shortcut.

update_projectC

Update fields on an existing Shortcut project.

delete_projectA

Permanently delete a Shortcut project. IRREVERSIBLE. Requires confirm_delete=true and confirm='CONFIRM_WRITE'.

list_linked_filesC

List all linked files in your Shortcut workspace.

create_linked_fileB

Create a linked file reference in Shortcut (e.g. Google Doc, Figma link).

bulk_update_storiesA

Update multiple stories at once. Provide story IDs and the fields to change on all of them.

bulk_move_storiesC

Move multiple stories to a different project and/or workflow state.

delete_story_linkA

Delete a link between two stories. IRREVERSIBLE. Requires confirm_delete=true and confirm='CONFIRM_WRITE'.

delete_story_taskA

Delete a checklist task from a Shortcut story. IRREVERSIBLE. Requires confirm_delete=true and confirm='CONFIRM_WRITE'.

get_story_historyC

Get the change history of a Shortcut story.

list_story_branchesB

List Git branches associated with a Shortcut story.

list_story_commitsB

List Git commits associated with a Shortcut story.

list_story_pull_requestsA

List pull requests associated with a Shortcut story.

list_epic_commentsB

List comments on a Shortcut epic.

create_epic_commentB

Create a comment on a Shortcut epic.

get_projectA

Get a Shortcut project by numeric project ID.

get_iterationC

Get a Shortcut iteration by numeric iteration ID.

get_labelB

Get a Shortcut label by numeric label ID.

get_memberA

Get a Shortcut member by UUID.

get_groupB

Get a Shortcut team/group by UUID.

delete_milestoneA

Permanently delete a Shortcut milestone. IRREVERSIBLE. Requires confirm_delete=true and confirm='CONFIRM_WRITE'.

delete_iterationA

Permanently delete a Shortcut iteration. IRREVERSIBLE. Requires confirm_delete=true and confirm='CONFIRM_WRITE'.

get_linked_fileB

Get a linked file by numeric ID.

update_linked_fileC

Update a linked file in Shortcut.

delete_linked_fileA

Permanently delete a linked file. IRREVERSIBLE. Requires confirm_delete=true and confirm='CONFIRM_WRITE'.

search_epicsC

Search Shortcut epics with query syntax.

list_entity_templatesA

List all story/epic templates in your Shortcut workspace.

list_repositoriesB

List all linked Git repositories in your Shortcut workspace.

bulk_delete_storiesA

Permanently delete multiple stories at once. IRREVERSIBLE. Requires confirm_delete=true and confirm='CONFIRM_WRITE'.

list_milestone_epicsA

List all epics belonging to a Shortcut milestone.

get_milestoneB

Get a Shortcut milestone by numeric milestone ID.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ptamb3/shortcut-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server