Shortcut MCP Server

What it does

The Shortcut MCP Server connects AI assistants directly to your Shortcut workspace, enabling them to search, create, and manage stories, epics, iterations, documents, and more. It bridges the gap between conversational AI and project management — ask your assistant to find stories, update epic statuses, or create iterations without leaving your editor.

Tools

• stories-search — Find Shortcut stories with filtering and search options
• stories-create — Create a new Shortcut story
• stories-update — Update an existing Shortcut story
• stories-get-by-id — Get a single story by ID
• stories-get-history — Get the change history for a story
• stories-get-branch-name — Get the recommended branch name for a story
• stories-upload-file — Upload a file and link it to a story
• stories-assign-current-user / stories-unassign-current-user — Manage story ownership
• stories-create-comment — Add a comment to a story
• stories-create-subtask / stories-add-subtask / stories-remove-subtask — Manage sub-tasks
• stories-add-relation — Add story relationships (blocks, duplicates, etc.)
• stories-add-external-link / stories-remove-external-link / stories-set-external-links / stories-get-by-external-link — Manage external links
• labels-list / labels-get-stories / labels-create — Manage workspace labels
• custom-fields-list — List custom fields and their possible values
• epics-search / epics-create / epics-update / epics-delete / epics-get-by-id / epics-create-comment — Full epic management
• iterations-search / iterations-create / iterations-update / iterations-delete / iterations-get-by-id / iterations-get-stories / iterations-get-active / iterations-get-upcoming — Iteration and sprint management
• objectives-get-by-id / objectives-search — View objectives
• teams-list / teams-get-by-id — Browse teams
• projects-list / projects-get-by-id / projects-get-stories — Project management
• workflows-list / workflows-get-by-id / workflows-get-default — Inspect workflows
• users-get-current / users-get-current-teams / users-list — User and team membership
• documents-create / documents-update / documents-list / documents-search / documents-get-by-id — Create and manage Shortcut documents

Installation

Cursor (hosted OAuth — no API token needed):

{
  "mcpServers": {
    "shortcut": {
      "url": "https://mcp.shortcut.com/mcp"
    }
  }
}

VS Code (hosted OAuth):

{
  "servers": {
    "shortcut-mcp": {
      "type": "http",
      "url": "https://mcp.shortcut.com/mcp"
    }
  }
}

Claude Desktop (local stdio):

{
  "mcpServers": {
    "shortcut": {
      "command": "npx",
      "args": ["-y", "@shortcut/mcp@latest"],
      "env": {
        "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
      }
    }
  }
}

Supported hosts

Cursor, VS Code, Claude Desktop, Windsurf, Zed, Claude Code