shortcut-mcp

shortcut-mcp

3
developer_toolsproject_management

The Shortcut MCP Server is designed to interact with the Shortcut platform, facilitating operations like viewing and creating projects and stories. It emphasizes safety with read-only and creation operations, ensuring no updates or deletions can occur.

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)

Setup

  1. Install Python with asdf.
  2. Create a virtual environment and install dependencies.
  3. Set up your environment.
  4. Run the server.

Safety Features

  • 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.

Code Quality

We use pylint for code quality checks.