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
Navigate to Settings or Customize > Connectors, and select + Add Custom Connector.
Enter a name (i.e., Shortcut MCP) and the following URL for the Remote MCP Server URL field (follow the authorization prompt after adding):https://mcp.shortcut.com/mcp
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:
- Ask for help in the community Slack
- Submit a support request or reach out at support@shortcut.com
You can also check the list of common issues below to see if there is a known solution already.
Updated