@shortcut/mcp

What it does

This MCP server bridges Shortcut, a project management platform, with Claude and other AI IDEs. It provides tools to query, create, and manage stories, labels, and other work items within Shortcut directly from your IDE. The server supports both a hosted OAuth-based endpoint and local installation, allowing you to interact with your Shortcut workspace from Claude in Cursor, VS Code, Claude Desktop, Windsurf, Zed, or Claude Code.

Who it's for

Engineers and teams using Shortcut for project tracking who want AI-assisted workflow integration. Primarily useful for developers working in Cursor or VS Code who need to query work items, create stories, or manage tasks without switching out of their editor.

Common use cases

• Query and search existing stories with filters and keywords from your IDE
• Create new stories or update existing ones without leaving your editor
• Add comments and manage subtasks programmatically
• Generate recommended branch names based on story details and workspace settings
• Link files, attachments, and external references to work items

Setup pitfalls

• The hosted server at https://mcp.shortcut.com/mcp is the primary option and requires OAuth; verify which endpoint your IDE documentation references, as local setup instructions vary.
• Local installations require IDE-specific configuration—Cursor, VS Code, Claude Desktop, and Windsurf each have different setup paths.
• The server is marked high-risk and reads your filesystem; consider sandbox and permission implications if running locally rather than using the hosted endpoint.
• No CI pipeline is documented; test local installations thoroughly before relying on them in production workflows.