Shortcut

Shortcut

Access and implement all of your projects and tasks (Stories) from Shortcut.

76
Stars
33
Forks
20
Releases

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.

Details

Owner
useshortcut
Language
TypeScript
License
MIT License
Updated
2025-12-07

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

Tags

shortcutmcpshortcutsstoriesepicsiterationsobjectivesteamsworkflowsusersdocuments