@shortcut/mcp

What it does

Shortcut MCP integrates the Shortcut project management platform with Claude-based editors and IDEs. Tools allow querying, creating, and updating stories (issues and tasks), managing assignments and comments, organizing with labels, and linking external resources. The primary installation method routes to Shortcut's hosted MCP server; local installation is available for IDEs requiring stdio-based transport.

Who it's for

Developers using Shortcut to track work, particularly backend and full-stack engineers in Claude Code, Cursor, VS Code, or Zed. Useful for teams where developers need to search requirements, create stories, and update project status without leaving their editor.

Common use cases

• Search stories by ID, title, status, or label while coding to reference requirements
• Create a new story and retrieve the recommended Git branch name
• Update story fields, assignments, comments, and subtasks from your editor
• Add subtasks to stories and establish relationships (blocks, duplicates, relates-to)
• Attach files and external links to stories to keep context centralized

Setup pitfalls

• The primary installation route is the hosted server at https://mcp.shortcut.com/mcp. Local setup via npm requires platform-specific configuration; see docs/local-server.md for your IDE.
• CI builds are currently failing. Check GitHub Actions logs before reporting issues.
• Store Shortcut API tokens securely — avoid hardcoding them in mcp.json or IDE settings files. Use OAuth authentication in supported clients (Cursor, VS Code).