Provides tools for interacting with Shortcut (formerly Clubhouse) to view and manage projects, stories, epics, and objectives, including capabilities for searching through stories and creating new items.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Shortcut MCP Servershow me the open stories in the mobile app project"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Shortcut MCP Server
This is a WIP server and might not work as intended.
A Model Context Protocol (MCP) server for interacting with Shortcut (formerly Clubhouse).
Features
View projects, stories, epics, and objectives
Search through stories
Create new stories, epics, and objectives
Safe operations only (no updates or deletions)
Related MCP server: Shortcut.com MCP Server
Setup
Install Python with asdf:
asdf installCreate virtual environment and install dependencies:
uv venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate
uv pip install -e . # Install package in editable modeSet up your environment:
cp .env.example .env
# Edit .env and add your Shortcut API tokenRun the server:
python -m shortcut_mcpProject Structure
shortcut-mcp/
├── src/
│ └── shortcut_mcp/ # Main package directory
│ ├── __init__.py # Package initialization
│ ├── __main__.py # Entry point
│ └── server.py # Server implementation
├── pyproject.toml # Project configuration
├── .tool-versions # ASDF version configuration
├── .pylintrc # Pylint configuration
└── README.mdUsing with Claude Desktop
Add this to your Claude Desktop config:
On MacOS (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"shortcut": {
"command": "python",
"args": ["-m", "shortcut_mcp"],
"env": {
"SHORTCUT_API_TOKEN": "your_token_here"
}
}
}
}On Windows (%AppData%\Claude\claude_desktop_config.json):
{
"mcpServers": {
"shortcut": {
"command": "python",
"args": ["-m", "shortcut_mcp"],
"env": {
"SHORTCUT_API_TOKEN": "your_token_here"
}
}
}
}Testing
You can test the server using the MCP Inspector:
npx @modelcontextprotocol/inspector python -m shortcut_mcpSafety Features
This server implements read-only operations with safe creation capabilities:
Only allows GET (read) and POST (create) operations
No modification or deletion of existing data
All operations are attributed to the API token owner
Development
Python Version Management
This project uses asdf for Python version management. The required Python version is specified in .tool-versions.
# Install Python with asdf
asdf install python
# The correct version will be automatically selected based on .tool-versionsCode Quality
We use pylint for code quality checks. Run it with:
pylint src/shortcut_mcpThe configuration for pylint is in .pylintrc.
This server cannot be installed
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.