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?
Connect Shortcut to tools like Cursor, Claude Code, and more. Access and edit Stories and Epics in the apps to get your agents started coding and connect the output directly to Github.
Shortcut MCP server has tools for finding, creating, and updating entities in Shortcut like Stories, Epics, and Docs.
Let us know how you and your agents use the Shortcut MCP to power your workflows! If you have questions, feedback, or requests for new MCP tools, reach out at support@shortcut.com
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 |
Setup Instructions
Please note that only a single API token can be provided, which is unique per workspace.
Claude Code
1. Open your ~/.claude.json config file
2. Add:
{
"mcpServers": {
"shortcut": {
"command": "npx",
"args": [
"-y",
"@shortcut/mcp@latest"
],
"env": {
"SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
}
}
}
}
Cursor
1. Open (or create) ~/.cursor/mcp.json
2. Add:
{
"mcpServers": {
"shortcut": {
"command": "npx",
"args": [
"-y",
"@shortcut/mcp@latest"
],
"env": {
"SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
}
}
}
}
Windsurf
1. Open the MCP Configuration Panel
2. Add:
{
"mcpServers": {
"shortcut": {
"command": "npx",
"args": [
"-y",
"@shortcut/mcp@latest"
],
"env": {
"SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
}
}
}
}
Zed
1. Open your settings.json file
2. Add:
"context_servers": {
"shortcut": {
"settings":{},
"command": {
"path": "<PATH/TO/NPX>",
"args": [
"-y",
"@shortcut/mcp@latest"
],
"env": {
"SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
}
}
}
}
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