@getguru/shortcut-mcp

Shortcut MCP server for stories, custom fields, and workflows.

Install

Use the MCP with npx (no global install):

npx @getguru/shortcut-mcp

Configure your MCP client (e.g. Cursor) with command npx and args @getguru/shortcut-mcp. Set SHORTCUT_API_TOKEN in the client's env. Generate a token at https://app.shortcut.com/settings/account/api-tokens.

Example MCP config (e.g. Cursor mcp.json or settings):

{
  "mcpServers": {
    "shortcut": {
      "command": "npx",
      "args": ["-y", "@getguru/shortcut-mcp"],
      "env": {
        "SHORTCUT_API_TOKEN": "your_shortcut_api_token_here"
      }
    }
  }
}

Tools

• shortcut_list_custom_fields — List custom field definitions for building story payloads
• shortcut_get_workflow — Get workflow by ID for default_state_id
• shortcut_create_story — Create a story (name, workflow_state_id, group_id, labels, epic_id, custom_fields, etc.)
• shortcut_get_story — Get story by ID (returns formatted_vcs_branch_name, app_url)
• shortcut_update_story — Update story (epic_id, external_links, description)