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
| Entity | Retrieve | Create | Update | Notes |
|---|---|---|---|---|
| Stories | ✅ | ✅ | ✅ | Full support, including comments and Sub-tasks |
| Epics | ✅ | ✅ | Can be created and retrieved | |
| Iterations | ✅ | ✅ | Can be created and retrieved | |
| Objectives | ✅ | Read-only | ||
| Teams | ✅ | Read-only | ||
| Members | ✅ | Read-only | ||
| Workflows | ✅ | Read-only | ||
| Docs | ✅ | ✅ | ✅ | Can be created, retrieved, and updated |
Setup Instructions
Please note that only a single API token can be provided, which is unique per workspace.
Cursor
The fastest way to get started is to connect to Shortcut's hosted MCP server. No API token or local setup required — authentication is handled via OAuth.
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).
Add the following details and save the file:
{
"mcpServers": {
"shortcut": {
"url": "https://mcp.shortcut.com/mcp"
}
}
}
Restart Cursor. You will be prompted to authorize with your Shortcut account on first use.
VS Code
If all you need is the configuration for the mcp.json file use this. You will be prompted to authorize with your Shortcut account on first use.
{
"servers": {
"shortcut-mcp": {
"type": "http",
"url": "https://mcp.shortcut.com/mcp"
}
}
}
For more details on installing MCP services in VSCode, see the official VS Code MCP docs for more information.
Claude Desktop
Download the package from this repo
Then, either double-click the icon to install or drag the package onto the client window. It should trigger the installation.
Other IDEs / Running Locally
If your IDE doesn't support HTTP-based MCP servers, or you'd prefer to run the server locally, see the Local Server Setup guide. This covers setup for Windsurf, Zed, Claude Code, and any IDE that supports stdio-based MCP servers.
Troubleshooting
Before doing anything else, please make sure you are running the latest version!
If you run into problems using this MCP server, you have a couple of options:
You can also check the list of common issues below to see if there is a known solution already.
Updated