Siri Shortcuts MCP Server

Overview

The Siri Shortcuts MCP server enables large language models to interact with Apple's Shortcuts automation platform on macOS. This integration allows LLMs to discover and execute any Shortcuts you've created or installed, providing powerful automation capabilities.

Installation

To install the Siri Shortcuts MCP server, you'll need to add it to your Claude configuration. You can install it using npx:

{
  "mcpServers": {
    "siri-shortcuts": {
      "command": "npx",
      "args": ["mcp-server-siri-shortcuts"]
    }
  }
}

Alternatively, you can clone the repository and run it locally:

1. Clone the repository: git clone https://github.com/dvcrn/mcp-server-siri-shortcuts.git
2. Navigate to the directory: cd mcp-server-siri-shortcuts
3. Install dependencies: npm install
4. Run the server: npm start

Requirements

• macOS with Shortcuts app installed
• Node.js environment

Usage

Once installed, the MCP server provides several ways to interact with Siri Shortcuts:

1. Discover available shortcuts: Use the list_shortcuts tool to see all shortcuts available on your system.

2. Open shortcuts in the editor: Use the open_shortcut tool to open a specific shortcut in the Shortcuts app for viewing or editing.

3. Execute shortcuts: Use either the generic run_shortcut tool or the dynamically generated shortcut-specific tools to execute shortcuts with optional input parameters.

The server automatically generates dedicated tools for each shortcut on your system, making it easy for the LLM to directly reference specific shortcuts.

Implementation Details

The MCP server uses the macOS shortcuts CLI command under the hood to interact with the Shortcuts app. It handles sanitizing shortcut names for tool naming compatibility and supports both direct text input and file-based input for shortcuts that accept parameters.

When a shortcut is executed, any output from the shortcut is returned to the LLM, allowing for two-way communication between the model and your automation workflows.