Overview
This MCP server provides access to Siri Shortcuts functionality via the Model Context Protocol (MCP). It exposes all shortcuts installed on the host macOS, allowing an LLM to list them, open a specific shortcut in the Shortcuts app, and execute a shortcut with optional input. It uses the macOS shortcuts CLI under the hood and sanitizes shortcut names to ensure tool identifiers are compatible with MCP tooling. The server offers three base tools: list_shortcuts (no input, returns an array of shortcuts), open_shortcut (requires a shortcut name), and run_shortcut (requires a name/UUID and accepts optional input). In addition, it automatically generates dynamic tools for each available shortcut in the format run_shortcut_<sanitized_name>, enabling precise per-shortcut invocation. Configuration via environment variables allows disabling dynamic tool generation (GENERATE_SHORTCUT_TOOLS) and injecting the list of shortcuts into the run_shortcut tool description (INJECT_SHORTCUT_LIST). The system supports both direct text input and file-based input, returns shortcut output when available, and includes standard MCP error handling.
Features
Expose all Shortcuts
Makes every installed Siri Shortcut available to the MCP server, enabling an LLM to call any shortcut via MCP tools.
List Shortcuts
Base tool list_shortcuts to enumerate all available Siri shortcuts on the system; returns an array of names.
Open Shortcuts
Base tool open_shortcut to open a specific shortcut in the Shortcuts app by name.
Run Shortcuts
Base tool run_shortcut to execute a shortcut with optional input, supporting name/UUID and optional text or file input.
Dynamic Per-Shortcut Tools
Automatically generates per-shortcut tools named run_shortcut_<sanitized_name> for direct invocation.
