The MCP server for Shortcut
See the official Windsurf docs for more information.
Windsurf MCP Configuration Panel
Add custom server
.{
"mcpServers": {
"shortcut": {
"command": "npx",
"args": [
"-y",
"@shortcut/mcp@latest"
],
"env": {
"SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
}
}
}
}
See the official Cursor docs for more information.
mcp.json
file (it should be in ~/.cursor/mcp.json
or <project-root>/.cursor/mcp.json
, but see Cursor docs for more details).{
"mcpServers": {
"shortcut": {
"command": "npx",
"args": [
"-y",
"@shortcut/mcp@latest"
],
"env": {
"SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
}
}
}
}
See the official Claude Code docs for more information.
You can add a new MCP server from the Claude Code CLI. But modifying the json file directly is simpler!
~/.claude.json
).projects
> mcpServers
section and add the following details and save the file:{
"projects": {
"mcpServers": {
"shortcut": {
"command": "npx",
"args": [
"-y",
"@shortcut/mcp@latest"
],
"env": {
"SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
}
}
}
}
}
settings.json
file. Instructions here "context_servers": {
"shortcut": {
"settings":{},
"command": {
"path": "<PATH/TO/NPX>",
"args": [
"-y",
"@shortcut/mcp@latest"
],
"env": {
"SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
}
}
}
}
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.
If you are using MISE for managing Node and NPM versions, you may encounter a "Client closed" error when trying to run the MCP server. Installing this extension into your IDE might help: https://github.com/hverlin/mise-vscode/.
npm install
npm run build
To test your local development version of the MCP server rather than using the published package, follow these steps:
Build the project:
npm run build
Create or modify your mcp.json
file to reference your local build:
{
"mcpServers": {
"shortcut": {
"command": "node",
"args": [
"/path/to/your/local/mcp-server-shortcut/dist/index.js"
],
"env": {
"SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
}
}
}
}
Place this mcp.json
file in one of the following locations:
~/.cursor/mcp.json
) or in your project directory (.cursor/mcp.json
)Restart your AI assistant (Cursor or Windsurf) to load the new configuration.
This allows you to instantly test changes to the MCP server without having to publish a new version.
{ "mcpServers": { "mcp-server-shortcut": { "command": "npx", "args": [ "-y", "@shortcut/mcp@latest" ] } } }
Related projects feature coming soon
Will recommend related projects based on sub-categories