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.
Shortcut MCP Server
Warning
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)
Setup
- Install Python with asdf:
- Create virtual environment and install dependencies:
- Set up your environment:
- Run the server:
Project Structure
Using with Claude Desktop
Add this to your Claude Desktop config:
On MacOS (~/Library/Application Support/Claude/claude_desktop_config.json
):
On Windows (%AppData%\Claude\claude_desktop_config.json
):
Testing
You can test the server using the MCP Inspector:
Safety 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
.
Code Quality
We use pylint for code quality checks. Run it with:
The configuration for pylint is in .pylintrc
.
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.
A Model Context Protocol server that enables interaction with Shortcut (formerly Clubhouse) project management tool, allowing users to view and search projects, stories, epics, and objectives, as well as create new items through natural language.
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA Model Context Protocol server that provides tools for code modification and generation via Large Language Models, allowing users to create, modify, rewrite, and delete files using structured XML instructions.Last updated -121PythonMIT License
- -securityFlicense-qualityAn 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.Last updated -Python
- -securityFlicense-qualityA Model Context Protocol server that helps collect and structure project portfolio information through a guided conversation flow.Last updated -TypeScript
- AsecurityAlicenseAqualityA Model Context Protocol server that provides comprehensive control over QuickBase operations, allowing users to manage applications, tables, fields, records, and relationships through MCP tools.Last updated -261TypeScriptMIT License