Shortcut MCP Server

Example Use Cases

• 1

  Search, retrieve, create, or update Shortcut stories and related metadata programmatically.

• 2

  Manage roadmap elements like epics, iterations, and objectives, including creating iterations and fetching active/upcoming iterations.

• 3

  Perform user- and team-focused tasks such as listing workspace users, getting current user info, assigning story owners, and uploading files to stories.

Description

This MCP server provides a bridge between model-enabled agents (Windsurf, Cursor, Claude Code, Zed, etc.) and the Shortcut API, exposing many common operations such as searching and creating stories, managing epics and iterations, uploading files, and listing users and teams. It supports easy installation via npx, configurable tool limiting via environment variables, and a read-only mode to prevent data modification. The project includes guidance for local development and testing so you can run a local build instead of the published package.