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
- Clone this repository:
- Create a virtual environment and install dependencies:
- Create a
.env
file in the project root directory with your Shortcut API token:
Running the Server
Start the MCP server using:
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:
- 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.py
if 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
This server cannot be installed
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.
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that enables Claude and other AI assistants to access and update Kintone data through natural language commands, supporting operations like record management, file handling, app administration, and space collaboration.Last updated -258JavaScriptAGPL 3.0
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants like Claude to interact with Outline document services, supporting document searching, reading, creation, editing, and comment management.Last updated -2529PythonMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server implementation that enables AI assistants like Claude to perform Google searches and retrieve web data directly through natural language requests.Last updated -163533TypeScriptMIT License
- AsecurityAlicenseAqualityA Model Context Protocol server that enables AI assistants like Claude to interact with microCMS content management system through six core tools for performing CRUD operations on microCMS list-type APIs.Last updated -101311TypeScriptMIT License