Shortcut.com MCP Server
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.
WynnD
README
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
-
Clone this repository:
git clone https://github.com/yourusername/mcp-server-shortcut.git cd mcp-server-shortcut -
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 -
Create a
.envfile 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:
-
Edit the Claude Desktop configuration file:
- Mac:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
- Mac:
-
Add the MCP server configuration:
{ "mcpServers": { "shortcut": { "command": "python", "args": ["-m", "src.server"], "env": { "SHORTCUT_API_TOKEN": "your_token_here" } } } } -
Restart Claude Desktop.
Available MCP Capabilities
Resources
shortcut://stories- Access a list of storiesshortcut://story/{story_id}- Access a specific story
Tools
list_stories- List stories with optional filteringsearch_stories- Search for stories using text queriesget_story_details- Get detailed information about a specific storycreate_story- Create a new storyupdate_story- Update an existing storyadd_comment- Add a comment to a storylist_workflow_states- List all workflow stateslist_projects- List all projects
Prompts
create_bug_report- Generate a template for bug reportscreate_feature_request- Generate a template for feature requests
Project Structure
src/- Source code directoryserver.py- Main MCP server implementationconfig.py- Configuration managementshortcut_client.py- Client for the Shortcut APIutils.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:
- Add any new API methods to
shortcut_client.py - Define Pydantic models in
utils.pyif needed - 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
- Use
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
Recommended Servers
@kazuph/mcp-taskmanager
Model Context Protocol server for Task Management. This allows Claude Desktop (or any MCP client) to manage and execute tasks in a queue-based system.
Claude Code MCP
An implementation of Claude Code as a Model Context Protocol server that enables using Claude's software engineering capabilities (code generation, editing, reviewing, and file operations) through the standardized MCP interface.
ThingsPanel MCP
An integration server that connects AI models with ThingsPanel IoT platform, allowing AI assistants to interact with IoT devices through natural language for device control, data retrieval, and management operations.
Beamlit MCP Server
An MCP server implementation that enables seamless integration between Beamlit CLI and AI models using the Model Context Protocol standard.
Shell MCP Server
A secure server that enables AI applications to execute shell commands in specified directories, supporting multiple shell types (bash, sh, cmd, powershell) with built-in security features like directory isolation and timeout control.
MCP Python Toolbox
A Model Context Protocol server that enables AI assistants like Claude to perform Python development tasks through file operations, code analysis, project management, and safe code execution.
Command Executor MCP Server
A Model Context Protocol server that allows secure execution of pre-approved commands, enabling AI assistants to safely interact with the user's system.
DevEnvInfoServer
An MCP server that provides detailed information about your development environment to the Cursor code editor, enabling more context-aware assistance.
Siri Shortcuts MCP Server
Enables interaction with macOS Siri Shortcuts via the Model Context Protocol, allowing users to list, open, and run shortcuts dynamically with optional inputs.
mcp-cli-exec MCP Server
A CLI command execution server that enables running shell commands with structured output, providing detailed execution results including stdout, stderr, exit code, and execution duration.