kriz-sgnl/shortcut-mcp-server

1- Complete API Coverage: The server supports all major Shortcut operations including:

• Stories (CRUD operations)
• Epics (create, read, update)
• Projects (create, read, update)
• Members and team management
• Labels and iterations
• Search functionality
• Workflow management

2- TypeScript Implementation:

• Full type safety with interfaces for all Shortcut entities
• Proper error handling and validation
• Modern ES modules structure

3- Robust Error Handling:

• API authentication validation
• Network error handling
• Detailed error messages
• Configuration validation

4- Easy Configuration:

• Simple API token setup
• Configurable base URL for enterprise instances
• Connection testing on configuration

Requires: Shortcut MCP Server for Claude desktop

Requires: nodejs and dir node_modules (https://nodejs.org/en/download)

What You Get

1- Main Server File (src/index.ts): Complete MCP server implementation with 20+ tools

2- Package Configuration (package.json): All necessary dependencies and scripts

3- TypeScript Config (tsconfig.json): Optimized for modern Node.js

4- Comprehensive Documentation (README.md): Setup instructions and API reference

Instructions

1- Install Claude Desktop

2- Create a local file: /Library/Application\ Support/Claude/claude_desktop_config.json

and use this JS:

MCP Server Configuration

Add this configuration to your MCP settings:

{
  "mcpServers": {
    "shortcut": {
      "command": "node",
      "args": ["/absolute/path/to/your/shortcut-mcp-server/build/index.js"],
      "env": {
        "NODE_ENV": "production"
      }
    }
  }
}

Important: Replace /absolute/path/to/your/shortcut-mcp-server

Usage

1- Install dependencies: npm install

2- Build the project: npm run build

3- Configure your MCP client to use the built server

4- Get your Shortcut API token from your account settings

5- Start using the tools after running shortcut_configure

The server provides a clean, consistent interface to Shortcut's powerful project management features, making it easy to integrate Shortcut operations into any MCP-compatible application or workflow.

When installed and server is running, open Claude desktop and type: "Configure Shortcut with these settings:

• API Token: YOUR_ACTUAL_TOKEN_HERE"