Summary
Ticket work that does not cost you a context switch.
Search, read, create, update and comment cover the loop most people actually run on Shortcut during a coding session. Listing the workflow states matters more than it sounds — it is what lets a status change name a state that exists in your workspace.
What it is
A Python MCP server for Shortcut.com ticket management, exposing stories, comments, workflow states and projects to an MCP client.
What you get
- Stories listed with filtering, and searched by text query when you only remember a phrase
- The full detail of a single story fetched by ID
- New stories created, and existing ones updated
- Comments added to a story
- Workflow states and projects listed, which is what makes a state change meaningful
- MCP resources alongside the tools: shortcut://stories for the list and shortcut://story/{story_id} for one story
Requirements
A Shortcut API token in SHORTCUT_API_TOKEN, set through a .env file or the client config, and Python 3.10 or newer.
Setup effort
Build from source — clone the repository and build it, then point your client at the binary