Skip to content
Shortcut MCP Server

Shortcut MCP Server

by Shortcut
Released
v0.25.0
MIT
Repository Docs npm
Productivity

Summary

Shortcut's hosted MCP server: find, create and update stories, epics, iterations and docs from Claude, Cursor or VS Code, authorised by OAuth rather than an API token.

Features

  • About 73 tools across stories, epics, iterations, milestones, projects, labels, workflows and members
  • Read, write, delete and archive operations, not just search
  • Hosted remote server at https://mcp.shortcut.com/mcp — nothing to run locally
  • OAuth authorisation, so no Shortcut API token to create or store
  • Connects from Claude, Cursor (~/.cursor/mcp.json) and VS Code (mcp.json)

Installation

Set up this MCP server in your favorite AI agent — copy a ready-made configuration below.

Any MCP-compatible agent

Most agents (Claude, Cursor, Windsurf, VS Code, and more) read a standard mcpServers configuration.

  1. Open your agent's MCP configuration file.
  2. Merge the snippet below into it.
  3. Restart the agent — the "Shortcut MCP Server" tools will be available.
{
  "mcpServers": {
    "shortcut-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.shortcut.com/mcp"
      ]
    }
  }
}

Description

Shortcut is the issue tracker a lot of product teams moved to for its story/epic/iteration model, and this is the company's official MCP server for it. The point of it is closing the loop that usually needs a human: an agent reads the story, understands what is broken, writes the fix, and marks the story complete without anyone copying a ticket ID between two windows.

It exposes Shortcut's project-management API as a broad tool surface — roughly 73 tools covering stories, epics, iterations, milestones, projects, labels, workflows, members and linked files, with read, write, delete and archive operations. Story management covers get, search, create and update; iteration management covers get, search and create plus retrieving the stories inside an iteration.

Shortcut has consolidated on a hosted remote server at https://mcp.shortcut.com/mcp, and authorisation is OAuth — there is no API token to mint, store or rotate, and the first use prompts you to authorise against your Shortcut account. Claude installs it as a connector; Cursor takes the URL in ~/.cursor/mcp.json; VS Code takes it as an http server in mcp.json.

The original self-hosted @shortcut/mcp npm package (MIT, useshortcut/mcp-server-shortcut) is still on the registry but its repository is now archived for historical reference — new work goes into the remote server, so point new installations at the hosted URL rather than the package.

Related MCP Servers

MCP: ClickUp

by ClickUp

Featured

ClickUp's official remote MCP server — around 40 tools across tasks, search, Docs, Chat and time tracking, over OAuth 2.1 with PKCE.

Productivity

MCP: Todoist

by Doist

Doist's official Todoist MCP server — a hosted OAuth endpoint that lets an agent find, create and update tasks and projects, with inline MCP Apps widgets for task lists.

Productivity

MCP: Teamwork.com MCP

by Teamwork.com

Teamwork.com's official MCP server for projects, tasks, time, Desk tickets, Spaces and Chat — with profile endpoints that trim the tool list to one role and an optional read-only mode.

Productivity

MCP: Linear

by Linear

Linear's official remote MCP server — create and update issues, search projects, and manage your team's workflow.

Productivity
Browse all MCP servers →