Shortcut MCP

What is shortcut-mcp

shortcut-mcp is a Model Context Protocol (MCP) server developed by Zekus. Designed to interact with Shortcut (formerly known as Clubhouse), this server provides a seamless way to manage various project management elements within the Shortcut ecosystem. Although currently a work-in-progress (WIP), shortcut-mcp enables users to view and create projects, stories, epics, and objectives, while ensuring safe operations by restricting updates and deletions. This server is part of a broader infrastructure that allows AI systems, like Claude, to interact with various data sources securely and effectively.

How to Use shortcut-mcp

To get started with shortcut-mcp, you need to set up your environment and run the server. Here’s a step-by-step guide:

1. Install Python: Use a version manager like asdf to install Python. This ensures compatibility and ease of management.

   asdf install
   

2. Create a Virtual Environment: Set up a virtual environment to manage dependencies separately from your system Python installation.

   uv venv
   source .venv/bin/activate  # On Windows, use .venv\Scripts\activate
   uv pip install -e .
   

3. Configure Environment: Copy the example environment file to a new .env file and edit it to include your Shortcut API token.

   cp .env.example .env
   

4. Run the Server: Start the server by executing the following command:

   python -m shortcut_mcp
   

For integration with Claude Desktop, you need to add specific configurations in your desktop config file, specifying the command to run the server and including your API token.

Key Features of shortcut-mcp

• Project Management: View and create projects, stories, epics, and objectives within the Shortcut platform. This server allows you to organize and manage your tasks effectively.

• Search Functionality: Easily search through stories to find specific details or updates, making it easier to track progress and manage tasks.

• Safe Operations: shortcut-mcp focuses on safe operations, allowing only read and creation actions. This means users can view and add new data without the risk of accidental updates or deletions.

• Integration with MCP: By leveraging the Model Context Protocol, shortcut-mcp provides a universal standard for secure AI interaction with project management data.

• Testing and Development: Users can test server operations using the MCP Inspector, ensuring everything functions as intended. The project also supports code quality checks with tools like pylint.

shortcut-mcp is a valuable tool for project managers and teams using Shortcut, offering a secure and efficient way to manage their projects. While still under development, it promises to enhance productivity by providing a reliable interface for interacting with project data.