Skip to main content

​
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.

​
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

​
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.