Siri Shortcuts MCP Server

This MCP server bridges the gap between Large Language Models (LLMs) and the macOS Shortcuts app, enabling access to Siri Shortcuts functionality via the Model Context Protocol (MCP). It allows LLMs to list, open, and execute shortcuts, effectively extending their capabilities with custom macOS workflows.

Features

• Exposes all shortcuts available in the Shortcuts app.
• Provides functionality to list available shortcuts.
• Enables opening shortcuts directly within the Shortcuts app.
• Supports running shortcuts with optional input parameters.
• Dynamically generates tools for each shortcut.

Tools

Base Tools

1. list_shortcuts: Lists all available Siri shortcuts, returning an array of shortcut names.
2. open_shortcut: Opens a specified shortcut in the Shortcuts app, requiring the shortcut's name as input.
3. run_shortcut: Executes a shortcut with optional text or file input.

Dynamic Tools

The server generates tools named run_shortcut_[sanitized_shortcut_name] for each shortcut, allowing direct execution. These tools accept optional text or file input.

Usage with Claude

To integrate with Claude, add the provided JSON configuration snippet, specifying the command and arguments to launch the server.

Implementation Details

The server leverages the macOS shortcuts CLI command. Shortcut names are sanitized for tool naming. It supports text and file-based input, returning shortcut output when available and implements standard MCP error handling.