Cursor

Overview

Connect Cursor to Shortcut through the hosted Shortcut MCP Server. Cursor can then use Shortcut context while planning, writing, and reviewing code.

Installation

1. Open or create ~/.cursor/mcp.json. For a project-only connection, use <project-root>/.cursor/mcp.json.
2. Add the Shortcut server:

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

3. Restart Cursor.
4. Follow the authorization prompt the first time Cursor connects to Shortcut.

Authentication is handled with OAuth. You do not need to create or store a Shortcut API token.

Use Shortcut from Cursor

In Cursor chat, ask for the Story or Epic context you need, for example:

• “Open Shortcut Story 12345 and create an implementation plan.”
• “Find Stories related to this repository.”
• “Add a comment to Story 12345 summarizing these changes.”

For available entities and troubleshooting, see MCP Server.