Provides integration with Shortcut's project management platform, allowing AI assistants to interact with Shortcut data using an API token for authentication.
@shortcut/mcp
The MCP server for Shortcut.
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:
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:
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:
Zed
- Open your
settings.json
file. Instructions here - Add the following details and save the file:
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
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:
- Create or modify your
mcp.json
file to reference your local build: - 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.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that integrates Shortcut project management functionality with AI assistants like Cursor, Windsurf, Claude Code, and Zed.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that enables interaction with Shortcut (formerly Clubhouse) project management tool, allowing users to view and search projects, stories, epics, and objectives, as well as create new items through natural language.Last updated -5Python
- -securityFlicense-qualityA Model Context Protocol server implementation that enables AI assistants to interact with Linear project management systems, allowing them to create, retrieve, and modify data related to issues, projects, teams, and users.Last updated -713TypeScript
- AsecurityAlicenseAqualityA Model Context Protocol server providing AI assistants with comprehensive project, task, and subtask management capabilities with project-specific storage.Last updated -295347TypeScriptMIT License
Shortcut MCP Serverofficial
AsecurityAlicenseAqualityA Model Context Protocol (MCP) server that integrates Shortcut project management with AI tools like Cursor, Windsurf, and Claude Code, allowing direct access to Shortcut data via API token.Last updated -322,24157TypeScriptMIT License