mcp -siri-shortcuts

This MCP server exposes Siri Shortcuts functionality to the Model Context Protocol. It allows a client (such as an LLM) to list all available shortcuts on the host Mac, open a specific shortcut in the Shortcuts app, and run a shortcut with optional textual or file-based input. In addition, the server dynamically generates tools for each available shortcut so that the LLM can invoke a specific shortcut directly via a dedicated tool named run_shortcut_<sanitized_shortcut_name>. Use the base tools to discover and interact with shortcuts, and rely on the dynamic tools when you know the exact shortcut you want to execute. The server leverages the macOS shortcuts CLI under the hood and provides standard MCP error handling.

Prerequisites:

• macOS with Shortcuts app installed
• Node.js installed (to run the MCP server via npx) or access to a npm registry for the package mcp-server-siri-shortcuts

Installation steps:

1. Ensure you have Node.js and npm installed:
   • macOS: install from https://nodejs.org/
2. Install or run the MCP server via npx (no global install required):
   • npx mcp-server-siri-shortcuts
3. (Optional) If you maintain a local setup, you can install the package locally:
   • npm install mcp-server-siri-shortcuts
4. Configure environment variables as needed (see additional notes for details) and run the server using the mcp_config provided in this document.

Notes and tips:

• By default, the server generates dynamic tools for each available Siri Shortcut. This can be disabled by setting GENERATE_SHORTCUT_TOOLS=false.
• If you want the LLM to be aware of which shortcuts exist, set INJECT_SHORTCUT_LIST=true to include the list of available shortcuts in the run_shortcut tool description.
• Ensure the macOS Shortcuts app has the necessary permissions for automation and access to run shortcuts from external tools.
• The server uses the macOS 'shortcuts' CLI under the hood, so behavior may depend on macOS version and Shortcuts availability.
• Tool names will be sanitized to be compatible with MCP tooling; dynamic tool names follow the pattern run_shortcut_<sanitized_shortcut_name>.
• If you experience issues, verify that the Shortcuts app is installed and that the CLI is functioning on your system (shortcuts list).