Advertise
MCP.so
Sign In

Shortcut.com MCP Server

@WynnD

Repository

Basic information

Category

Productivity

Transports

stdio

Author

WynnD

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

8

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

1

What are the prerequisites for Shortcut.com MCP Server?

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

2

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.

3

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).

4

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`.

5

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

Kalender Sync

PPJ Venture Labs UG (haftungsbeschränkt)

Connect Google, Microsoft 365/Outlook, iCloud and CalDAV calendars to your AI assistant. Check availability, find and manage events, respond to supported invitations, and create, inspect, pause or delete calendar syncs w

My AskAI

My AskAI

Use My AskAI to find product, setup, integration, API, feature, pricing, and troubleshooting information. Search the public knowledge base, read complete documentation and OpenAPI files, and estimate pricing from monthly

Nilyo

Your own LinkedIn, WhatsApp, Instagram, Telegram, Email and Calendar accounts, usable from any agent — search, read and act on your own accounts.

Common Paper Contracts

Common Paper, Inc.

Common Paper is a contract platform for revenue and legal teams. Create templates, customize contracts, negotiate terms with counterparties, collect signatures, and kick off billing - all from one workflow. Ask what's

Etincel

AIStoryHub

Find the AI tells in your prose. Deterministic, local, runs in CI. MCP server + CLI + Action.

6
Advertise