Overview
This MCP server acts as a bridge between AI assistants and Shortcut, exposing Shortcut data and operations through the Model Context Protocol (MCP). It supports a broad set of tools for managing Shortcut content, including retrieving a story by ID, searching stories with filters, creating and updating stories, attaching files, assigning ownership, and adding comments, tasks, and external links. The README enumerates tools for Epics, Iterations, Objectives, Teams, Workflows, Users, and Documents, enabling read and write interactions across multiple Shortcut entities. Configuration is achieved by running the MCP server via npm/npx commands (for example, npx @shortcut/mcp@latest) and supplying a SHORTCUT_API_TOKEN. The server can be guided by environment variables to limit available tools (SHORTCUT_TOOLS) and to enable read-only mode (SHORTCUT_READONLY). Example configurations are provided for Windsurf, Cursor, Claude Code, and Zed. The goal is to empower developers and AI agents to programmatically interact with Shortcut data in a secure, configurable, and scalable way.
Features
stories-get-by-id
Get a single Shortcut story by ID
stories-search
Find Shortcut stories with filtering and search options
stories-create
Create a new Shortcut story
stories-update
Update an existing Shortcut story
stories-upload-file
Upload a file and link it to a story
stories-assign-current-user
Assign the current user as the owner of a story
stories-create-comment
Create a comment on a story
stories-add-task
Add a task to a story




