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
- Clone this repository:Copy
- Create a virtual environment and install dependencies:Copy
- Create a
.env
file in the project root directory with your Shortcut API token:Copy
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:Copy
- 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
- -securityFlicense-qualityA 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 -5TypeScript
- -securityAlicense-qualityA 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 -1PythonMIT License
- -securityFlicense-qualityA 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 -275JavaScript
- AsecurityAlicenseAqualityA 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 -93TypeScriptMIT License