shortcut-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SHORTCUT_API_TOKEN | Yes | Your Shortcut API token, found in your Shortcut settings. |
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": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search-storiesB | Search for stories in Shortcut using powerful search operators |
| get-storyA | Get detailed information about a specific story by ID (fastest way to look up a story) |
| list-archived-storiesC | List only archived stories |
| list-my-archived-storiesB | List only archived stories assigned to you |
| list-my-storiesC | List stories assigned to you |
| list-stories-by-state-nameC | List stories by workflow state name |
| create-storyB | Create a new story in Shortcut |
| list-projectsA | [DEPRECATED] List all projects in Shortcut. Projects have been deprecated by Shortcut, please use teams instead. |
| list-teamsA | List all teams in Shortcut |
| list-workflowsB | List all workflows and their states |
| list-objectivesC | List objectives in Shortcut |
| create-objectiveB | Create a new objective in Shortcut |
| list-epicsC | List epics in Shortcut |
| create-epicC | Create a new epic in Shortcut |
| list-stories-by-statusC | List stories by workflow state ID |
| update-storyC | Update an existing story in Shortcut |
| update-story-statusC | Update a story's status in Shortcut |
| health-checkA | Check the health and connectivity of the Shortcut MCP server |
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 18 tools
All tools have clearly distinct purposes. Create tools target different resources, and list tools are well-differentiated by filters (archived, assigned to me, by state, etc.). No two tools appear to do the same thing.
All tool names follow a consistent verb_noun pattern in snake_case (e.g., create-epic, list-stories-by-state-name). Even the deprecated tool uses the same pattern, ensuring predictable naming.
With 18 tools, the server covers the core Shortcut entities (epics, objectives, stories, workflows, teams) without being overwhelming. Each tool earns its place for standard project management operations.
The tool set lacks update operations for epics and objectives, and there are no delete capabilities for any resource. This leaves significant gaps in CRUD coverage, forcing agents to work around missing lifecycle support.