
mcp-server-shortcut
The MCP server for Shortcut
7
Github Watches
10
Github Forks
18
Github Stars
@shortcut/mcp
Usage
Windsurf
See the official Windsurf docs for more information.
- Open the
Windsurf MCP Configuration Panel
- Click
Add custom server
. - Add the following details and save the file:
{
"mcpServers": {
"shortcut": {
"command": "npx",
"args": [
"-y",
"@shortcut/mcp"
],
"env": {
"SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
}
}
}
}
Cursor
See the official Cursor docs for more information.
- 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": {
"command": "npx",
"args": [
"-y",
"@shortcut/mcp"
],
"env": {
"SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
}
}
}
}
Claude Code
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!
- Open the Claude Code configuration file (it should be in
~/.claude.json
). - Find the
projects
>mcpServers
section and add the following details and save the file:
{
"projects": {
"mcpServers": {
"shortcut": {
"command": "npx",
"args": [
"-y",
"@shortcut/mcp"
],
"env": {
"SHORTCUT_API_TOKEN": "<YOUR_SHORTCUT_API_TOKEN>"
}
}
}
}
}
Issues and 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.
Common Issues and Solutions
NPX command not working when using MISE for version management
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/.
Development
Installation
npm install
Build
npm run build
Running the Development Server Locally
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:- For Cursor: In your home directory (
~/.cursor/mcp.json
) or in your project directory (.cursor/mcp.json
) - For Windsurf: Use the MCP Configuration Panel to add the custom server
- For Cursor: In your home directory (
-
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.
相关推荐
I find academic articles and books for research and literature reviews.
Confidential guide on numerology and astrology, based of GG33 Public information
Converts Figma frames into front-end code for various mobile frameworks.
Advanced software engineer GPT that excels through nailing the basics.
Take an adjectivised noun, and create images making it progressively more adjective!
Embark on a thrilling diplomatic quest across a galaxy on the brink of war. Navigate complex politics and alien cultures to forge peace and avert catastrophe in this immersive interstellar adventure.
Discover the most comprehensive and up-to-date collection of MCP servers in the market. This repository serves as a centralized hub, offering an extensive catalog of open-source and proprietary MCP servers, complete with features, documentation links, and contributors.
Micropython I2C-based manipulation of the MCP series GPIO expander, derived from Adafruit_MCP230xx
The all-in-one Desktop & Docker AI application with built-in RAG, AI agents, No-code agent builder, MCP compatibility, and more.
Bridge between Ollama and MCP servers, enabling local LLMs to use Model Context Protocol tools
🧑🚀 全世界最好的LLM资料总结(Agent框架、辅助编程、数据处理、模型训练、模型推理、o1 模型、MCP、小语言模型、视觉语言模型) | Summary of the world's best LLM resources.
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
Reviews

user_KfsSljGU
As a longtime user of mcp-server-shortcut, I am thoroughly impressed by its efficiency and ease of use. The seamless integration and straightforward functionalities make it an invaluable tool for server management. Highly recommended for anyone looking to simplify their workflow. Great job, useshortcut!