At a glance
- Availability: Experimental (how to enable).
- Auth: API key.
- Connection: The key from
SHORTCUT_API_TOKENis sent as theShortcut-Tokenheader. - Docs: https://developer.shortcut.com/api/rest/v3
Credentials
Set these per environment. See Connect an integration.| Variable | Required | Description |
|---|---|---|
SHORTCUT_API_TOKEN | Yes | Shortcut API token (Settings > Account > API Tokens) Docs. |
Setup
- Sign in to Shortcut: Go to https://app.shortcut.com and sign in. A free trial workspace is sufficient for testing.
- Generate an API token: Open Settings > Account > API Tokens (https://app.shortcut.com/settings/account/api-tokens), name the token, and generate it. Tokens are scoped to the workspace you create them in.
- Set the environment variable: Add the token to your .env as SHORTCUT_API_TOKEN=…
- Verify access: Run List Workflows, then Search Stories with a simple query.
- Shortcut authenticates with a ‘Shortcut-Token’ header, not Authorization
- Creating stories needs a workflow_state_id - call List Workflows first
- Rate limit is 200 requests per minute
Tools
| Tool | Access | Description |
|---|---|---|
| Search Stories | Read | Search Shortcut stories with the Shortcut search syntax |
| Get Story | Read | Get a Shortcut story by its public ID |
| Create Story | Write | Create a new story in Shortcut |
| Update Story | Write | Update an existing Shortcut story |
| List Epics | Read | List epics in the Shortcut workspace |
| List Members | Read | List members of the Shortcut workspace (use member UUIDs as owner_ids) |
| List Workflows | Read | List workflows and their states (use state IDs as workflow_state_id) |
Example prompts
- Search Shortcut for stories owned by me that are in progress and summarize them.
- Create a bug story in Shortcut with a clear title and reproduction steps.