Shortcut

At a glance

Availability: Experimental (how to enable).
Auth: API key.
Connection: The key from SHORTCUT_API_TOKEN is sent as the Shortcut-Token header.
Docs: https://developer.shortcut.com/api/rest/v3

Set these per environment. See Connect an integration.

Variable	Required	Description
`SHORTCUT_API_TOKEN`	Yes	Shortcut API token (Settings > Account > API Tokens) Docs.

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.

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)

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.