Shortcut

{/* Generated by scripts/generate-integration-catalog.mjs. Do not edit by hand. */}

At a glance

  • Availability: Experimental (how to enable).
  • Authentication: API key.
  • Connection: The key from SHORTCUT_API_TOKEN is sent as the Shortcut-Token header.
  • Provider documentation: Authentication reference.

Credentials

Set these per environment. See Connect an integration.

VariableRequiredDescription
SHORTCUT_API_TOKENYesShortcut API token (Settings > Account > API Tokens) Docs.

Setup

  1. Sign in to Shortcut: Go to https://app.shortcut.com and sign in. A free trial workspace is sufficient for testing.
  2. 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.
  3. Set the environment variable: Add the token to your .env as SHORTCUT_API_TOKEN=...
  4. Verify access: Run List Workflows, then Search Stories with a simple query.

Provider notes

  • 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

Provider API reference.

Tools

ToolAccessDescription
Search Stories<br /><code className="reference-identifier">shortcut__search_stories</code>ReadSearch stories
Get Story<br /><code className="reference-identifier">shortcut__get_story</code>ReadGet story
Create Story<br /><code className="reference-identifier">shortcut__create_story</code>WriteCreate story
Update Story<br /><code className="reference-identifier">shortcut__update_story</code>WriteUpdate story
List Epics<br /><code className="reference-identifier">shortcut__list_epics</code>ReadList epics
List Members<br /><code className="reference-identifier">shortcut__list_members</code>ReadList members
List Workflows<br /><code className="reference-identifier">shortcut__list_workflows</code>ReadList workflows

Verify the connection

Call a read tool such as shortcut__search_stories with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.