Use the Shortcut MCP server to access your Shortcut workspace data in a simple and secure way.

MCP is an open protocol that enables AI models to securely interact with local and remote resources through standardized server implementations.

What does the open source Shortcut MCP Server do?

Supported Entities

Setup Instructions

Please note that only a single API token can be provided, which is unique per workspace.

Claude Code

See the official Claude Code docs for more information.

Add the MCP server from the command line:

claude mcp add shortcut --transport stdio -e SHORTCUT_API_TOKEN=$SHORTCUT_API_TOKEN -- npx -y @shortcut/mcp@latest

Or you can create a .mcp.json file in your project root to share with your team:

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

Cursor

See the official Cursor docs for more information.

1. Open (or create) the mcp.json file (it should be in ~/.cursor/mcp.json or <project-root>/.cursor/mcp.json, but see Cursor docs for more details).
2. Add the following details and save the file:

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

‍

See the official VS Code MCP docs for more information.

1. Create (or open) the .vscode/mcp.json file in your workspace.
2. Add the following details and save the file:

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

See the official OpenCode MCP docs for more information.

Add the following to your opencode.json configuration file:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "shortcut": {
      "type": "local",
      "command": ["npx", "-y", "@shortcut/mcp@latest"],
      "environment": {
        "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
      }
    }
  }
}

Windsurf 

See the official Windsurf docs for more information.

1. Open the MCP configuration by clicking the MCPs icon in the Cascade panel, or navigate to Windsurf Settings > Cascade > MCP Servers.
2. Click Add Custom Server to edit the raw mcp_config.json file (located at ~/.codeium/windsurf/mcp_config.json).
3. Add the following details and save the file:

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

Zed

See the official Zed MCP docs for more information.

1. Open your settings.json file. Instructions here.
2. Add the following to the context_servers section and save the file:

 "context_servers": {
    "shortcut": {
      "settings":{},
      "command": {
        "path": "<PATH/TO/NPX>",
        "args": [
          "-y",
          "@shortcut/mcp@latest"
        ],
        "env": {
          "SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
        }
      }
    }
  }

‍

Updated February 20, 2026 16:07