Shortcut MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SHORTCUT_API_TOKEN | Yes | Your 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
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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