Shortcut.com MCP Server

by WynnD

Integrations

  • Provides tools for interacting with Shortcut.com's ticket management system, allowing users to list, search, create, and update stories (tickets), add comments, and retrieve workflow states and projects.

Shortcut.com MCP Server

An implementation of a Model Context Protocol (MCP) server for accessing and searching tickets on Shortcut.com.

Overview

This project implements an MCP server that allows Claude and other MCP-compatible AI assistants to interact with Shortcut.com's ticket management system. With this integration, AI assistants can:

  • List and search for stories (tickets) in Shortcut
  • Get detailed information about specific stories
  • Create new stories
  • Update existing stories
  • Add comments to stories
  • Retrieve workflow states and projects

Prerequisites

  • Python 3.10+
  • Shortcut.com API token

Installation

  1. Clone this repository:
    git clone https://github.com/yourusername/mcp-server-shortcut.git cd mcp-server-shortcut
  2. Create a virtual environment and install dependencies:
    # Using uv (recommended) curl -LsSf https://astral.sh/uv/install.sh | sh # For Mac/Linux uv venv source .venv/bin/activate # On Mac/Linux or .venv\Scripts\activate on Windows uv pip install -r requirements.txt # Using pip python -m venv venv source venv/bin/activate # On Mac/Linux or venv\Scripts\activate on Windows pip install -r requirements.txt
  3. Create a .env file in the project root directory with your Shortcut API token:
    SHORTCUT_API_TOKEN=your_token_here SERVER_PORT=5000 SERVER_HOST=0.0.0.0 DEBUG_MODE=True

Running the Server

Start the MCP server using:

python -m src.server

Configuring Claude Desktop

To use this MCP server with Claude Desktop:

  1. Edit the Claude Desktop configuration file:
    • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  2. Add the MCP server configuration:
    { "mcpServers": { "shortcut": { "command": "python", "args": ["-m", "src.server"], "env": { "SHORTCUT_API_TOKEN": "your_token_here" } } } }
  3. Restart Claude Desktop.

Available MCP Capabilities

Resources

  • shortcut://stories - Access a list of stories
  • shortcut://story/{story_id} - Access a specific story

Tools

  • list_stories - List stories with optional filtering
  • search_stories - Search for stories using text queries
  • get_story_details - Get detailed information about a specific story
  • create_story - Create a new story
  • update_story - Update an existing story
  • add_comment - Add a comment to a story
  • list_workflow_states - List all workflow states
  • list_projects - List all projects

Prompts

  • create_bug_report - Generate a template for bug reports
  • create_feature_request - Generate a template for feature requests

Project Structure

  • src/ - Source code directory
    • server.py - Main MCP server implementation
    • config.py - Configuration management
    • shortcut_client.py - Client for the Shortcut API
    • utils.py - Utility functions and data models
  • requirements.txt - Project dependencies
  • .env - Environment variables (not tracked in git)

Development

Adding New Capabilities

To add a new capability to the MCP server:

  1. Add any new API methods to shortcut_client.py
  2. Define Pydantic models in utils.py if needed
  3. Implement the MCP functionality using decorators in server.py:
    • Use @mcp.resource() for read-only resources
    • Use @mcp.tool() for actions that can modify data
    • Use @mcp.prompt() for generating templates or structured text

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License

-
security - not tested
F
license - not found
-
quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

An implementation of a Model Context Protocol server that allows Claude and other AI assistants to interact with Shortcut.com's ticket management system for searching, viewing, creating, and updating stories.

  1. Overview
    1. Prerequisites
      1. Installation
        1. Running the Server
          1. Configuring Claude Desktop
            1. Available MCP Capabilities
              1. Resources
              2. Tools
              3. Prompts
            2. Project Structure
              1. Development
                1. Adding New Capabilities
              2. Contributing
                1. License

                  Related MCP Servers

                  • -
                    security
                    F
                    license
                    -
                    quality
                    A comprehensive suite of Model Context Protocol servers designed to extend AI agent Claude's capabilities with integrations for knowledge management, reasoning, advanced search, news access, and workspace tools.
                    Last updated -
                    5
                    TypeScript
                    • Apple
                  • -
                    security
                    A
                    license
                    -
                    quality
                    A Model Context Protocol server that enables AI assistants like Claude to browse and analyze Reddit content, including searching subreddits, retrieving post details with comments, and viewing trending posts.
                    Last updated -
                    1
                    Python
                    MIT License
                    • Apple
                  • -
                    security
                    F
                    license
                    -
                    quality
                    A Model Context Protocol server that connects AI assistants like Claude to Notion workspaces, enabling them to view, search, create, and update Notion databases, pages, and content blocks.
                    Last updated -
                    275
                    JavaScript
                    • Apple
                  • A
                    security
                    A
                    license
                    A
                    quality
                    A Model Context Protocol server that enables AI assistants to interact with Confluence content, supporting operations like retrieving, searching, creating, and updating pages and spaces.
                    Last updated -
                    9
                    3
                    TypeScript
                    MIT License

                  View all related MCP servers

                  ID: aarv4idi9x