Shortcut.com MCP Server

@WynnD

Basic information

About Shortcut.com MCP Server

MCP Server for Shortcut

Shortcut.com MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-shortcut": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Shortcut.com MCP Server tools

List stories with optional filtering

Search for stories using text queries

Get detailed information about a specific story

Create a new story

Update an existing story

Add a comment to a story

List all workflow states

List all projects

Overview

What is Shortcut.com MCP Server?

An implementation of the Model Context Protocol (MCP) server that allows Claude and other MCP-compatible AI assistants to interact with Shortcut.com’s ticket management system. It enables listing, searching, creating, updating stories, and adding comments, as well as retrieving workflow states and projects.

How to use Shortcut.com MCP Server?

Install Python 3.10+, clone the repository, create a virtual environment, install dependencies, and set up a .env file with your Shortcut API token. Run the server with python -m src.server. To use with Claude Desktop, add the server configuration to claude_desktop_config.json with the SHORTCUT_API_TOKEN environment variable.

Key features of Shortcut.com MCP Server

List and search stories (tickets) in Shortcut.
Get detailed information about specific stories.
Create and update stories.
Add comments to stories.
Retrieve workflow states and projects.
Provides pre-built bug report and feature request templates.

Use cases of Shortcut.com MCP Server

Automate bug report creation from AI conversations.
Quickly search and retrieve story details without leaving the chat.
Update story statuses or add comments via natural language commands.
Generate structured feature request templates for new work items.

Frequently asked questions

What are the prerequisites for Shortcut.com MCP Server?

Python 3.10+ and a Shortcut.com API token are required.

How do I configure Shortcut.com MCP Server with Claude Desktop?

Edit the Claude Desktop configuration file (`claude_desktop_config.json`) and add the server entry with the `command`, `args`, and `env` containing the `SHORTCUT_API_TOKEN`. Then restart Claude Desktop.

What MCP capabilities does the server provide?

It exposes resources (`shortcut://stories`, `shortcut://story/{story_id}`), tools (list, search, create, update, add comment, list workflow states, list projects), and prompts (create bug report, create feature request).

How can I add new capabilities to the server?

Add API methods to `shortcut_client.py`, define Pydantic models in `utils.py` if needed, and implement MCP functionality using decorators (`@mcp.resource`, `@mcp.tool`, `@mcp.prompt`) in `server.py`.

Is the server open source and how is it licensed?

Yes, contributions are welcome. The project is licensed under the MIT License.

Comments

More Productivity MCP servers

GetSales: Outreach MCP Server

GetSales

An AI agent works your GetSales workspace from Claude, Cursor or ChatGPT: tables of people and companies, enrichment, workflows, the inbox, tasks and signals.

TruLata

Your TruLata marketing account from any MCP client: leads, dashboard numbers, website edits, articles, brand assets, Google and Meta ads, teammates and support. 24 tools. AI marketing software for service businesses. Sig

Twistly AI Presentation Maker

Twistly

Twistly turns your ideas, notes, and documents into ready-to-edit PowerPoint presentations. Describe a topic, paste in text, or share a file (PDF, DOCX, PPTX, or TXT), and Twistly builds a structured deck of up to 50 sli

Comuna

Comuna is a free-forever team workspace (Kanban, table, calendar, Gantt, chat, notes, wiki) where your AI is a real board member. Connect Claude or ChatGPT via MCP in 60 seconds: 80+ tools to work cards under its own ide

Fdback.io

Fdback

Fdback.io is a user feedback platform (feedback board, roadmap, changelog) with a built-in remote MCP server - no local install, connect any MCP client with a URL and API key. Your AI agents can: - List, search, and rea