shortcut-mcp-server

A Model Context Protocol server for Shortcut.

Catalog onlyCatalog onlySTDIO

Overview

The Shortcut MCP Server is a Message Control Protocol server implementation that facilitates integration with the Shortcut project management platform, enabling enhanced communication and functionality.

To use the Shortcut MCP Server, you need to clone the repository, install the necessary dependencies, configure your environment with a Shortcut API token, and then start the development server.

Implementation of the MCP protocol for standardized messaging - Integration with the Shortcut API for feature control - Efficient message routing and handling capabilities - Secure communication during message exchange

Automating project management tasks via Shortcut.
Enabling seamless integrations between Shortcut and other tools.
Facilitating real-time communication for project updates and notifications.

Add to your AI client

Use these steps to connect shortcut-mcp-server in Cursor, Claude, VS Code, and other MCP-compatible apps. The same JSON appears in the Use with menu above for one-click copy.

Cursor

Add this to your .cursor/mcp.json file in your project root, then restart Cursor.

.cursor/mcp.json

{
  "mcpServers": {
    "shortcut-mcp-server-madisonbullard": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-shortcut-mcp-server-madisonbullard"
      ]
    }
  }
}

Claude Desktop

Add this server entry to the mcpServers object in your Claude Desktop config, then restart the app.

~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows)

{
  "mcpServers": {
    "shortcut-mcp-server-madisonbullard": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-shortcut-mcp-server-madisonbullard"
      ]
    }
  }
}

Claude Code

Add this to your project's .mcp.json file. Claude Code will detect it automatically.

.mcp.json (project root)

{
  "mcpServers": {
    "shortcut-mcp-server-madisonbullard": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-shortcut-mcp-server-madisonbullard"
      ]
    }
  }
}

VS Code (Copilot)

Add this to your .vscode/mcp.json file. Requires the GitHub Copilot extension with MCP support enabled.

.vscode/mcp.json

{
  "servers": {
    "shortcut-mcp-server-madisonbullard": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-shortcut-mcp-server-madisonbullard"
      ]
    }
  }
}

Windsurf

Add this to your Windsurf MCP config file, then restart Windsurf.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "shortcut-mcp-server-madisonbullard": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-shortcut-mcp-server-madisonbullard"
      ]
    }
  }
}

Cline

Open Cline settings, navigate to MCP Servers, and add this server configuration.

Cline MCP Settings (via UI)

{
  "mcpServers": {
    "shortcut-mcp-server-madisonbullard": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-shortcut-mcp-server-madisonbullard"
      ]
    }
  }
}

FAQ

What are the prerequisites to run the Shortcut MCP Server?

You will need Node.js (v18 or higher), npm or yarn, and a valid Shortcut API token.

How do I install the Shortcut MCP Server?

You can install it by cloning the repository and following the installation instructions in the README.

Is the Shortcut MCP Server open-source?

Yes! The Shortcut MCP Server is available on GitHub under the MIT license.

Developer tools

shortcut-mcp-server — MCP Registry