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 |
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
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get-current-userB | Get the current user |
| list-membersC | Get all members |
| get-story-branch-nameC | Get a valid branch name for a specific story. |
| get-storyC | Get a Shortcut story by public ID |
| search-storiesC | Find Shortcut stories. |
| create-storyA | Create a new Shortcut story. Name is required, and either a Team or Workflow must be specified:
|
| update-storyC | Update an existing Shortcut story. Only provide fields you want to update. The story public ID will always be included in updates. |
| assign-current-user-as-ownerC | Assign the current user as the owner of a story |
| unassign-current-user-as-ownerC | Unassign the current user as the owner of a story |
| create-story-commentC | Create a comment on a story |
| add-task-to-storyC | Add a task to a story |
| add-relation-to-storyC | Add a story relationship to a story |
| update-taskC | Update a task in a story |
| add-external-link-to-storyC | Add an external link to a Shortcut story |
| remove-external-link-from-storyC | Remove an external link from a Shortcut story |
| get-stories-by-external-linkC | Find all stories that contain a specific external link |
| set-story-external-linksC | Replace all external links on a story with a new set of links |
| get-iteration-storiesC | Get stories in a specific iteration by iteration public ID |
| get-iterationB | Get a Shortcut iteration by public ID |
| search-iterationsC | Find Shortcut iterations. |
| create-iterationC | Create a new Shortcut iteration |
| get-active-iterationsB | Get the active Shortcut iterations for the current user based on their team memberships |
| get-upcoming-iterationsB | Get the upcoming Shortcut iterations for the current user based on their team memberships |
| get-epicB | Get a Shortcut epic by public ID |
| search-epicsC | Find Shortcut epics. |
| create-epicC | Create a new Shortcut epic. |
| get-objectiveC | Get a Shortcut objective by public ID |
| search-objectivesC | Find Shortcut objectives. |
| get-teamB | Get a Shortcut team by public ID |
| list-teamsB | List all Shortcut teams |
| get-workflowC | Get a Shortcut workflow by public ID |
| list-workflowsB | List all Shortcut workflows |
| create-documentA | Create a new document in Shortcut with a title and content. Returns the document's id, title, and app_url. Note: Use HTML markup for the content (e.g., , , , ) rather than Markdown. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 33 tools
Each tool has a clearly distinct purpose targeting specific resources and actions in Shortcut, such as stories, epics, iterations, and users. There is no significant overlap; for example, 'create-story' and 'update-story' are distinct, and 'add-external-link-to-story' and 'set-story-external-links' serve different functions (add vs. replace).
Tool names follow a consistent verb-object pattern with hyphens (e.g., 'create-story', 'get-iteration'), making them readable and predictable. Minor deviations exist, such as 'assign-current-user-as-owner' being more verbose, but overall, the naming is highly consistent across the set.
With 33 tools, the count is borderline high for a project management server, potentially overwhelming for agents. While it covers many operations, it might be slightly heavy compared to typical well-scoped servers (3-15 tools), though not extreme.
The tool set provides comprehensive CRUD and lifecycle coverage for Shortcut's domain, including stories, epics, iterations, documents, and users. It supports creation, retrieval, updating, deletion (via removal tools), and search operations, with no obvious gaps for core workflows.