📌Overview

Purpose: This MCP server enables access to Siri shortcuts through the Model Context Protocol, allowing users to list, open, and execute shortcuts from the macOS Shortcuts app.

Overview: The Siri Shortcuts MCP Server serves as an interface to interact with various Siri shortcuts on macOS, providing a comprehensive set of functionalities to manage and utilize shortcuts effectively.

Key Features:

• Access to All Shortcuts: Exposes all Siri shortcuts available on the system, enabling seamless interaction through language models.

• Shortcut Management: Includes tools to list all available shortcuts, open them in the Shortcuts app, and run them with optional input parameters, enhancing user flexibility.

• Dynamic Tool Generation: Automatically creates dedicated tools for each available shortcut, allowing easy execution through customizable input options.

---

Siri Shortcuts MCP Server

This MCP server provides access to Siri shortcuts functionality via the Model Context Protocol (MCP). It allows listing, opening, and running shortcuts from the macOS Shortcuts app.

Features

• Access all shortcuts available in the Shortcuts app.
• List all available shortcuts.
• Open shortcuts in the Shortcuts app.
• Run shortcuts with optional input parameters.
• Dynamically generated tools for each available shortcut.

Tools

Base Tools

1. list_shortcuts

   • Lists all available Siri shortcuts on the system.
   • No input required.
   • Returns: Array of shortcut names.

   {
     "shortcuts": [{ "name": "My Shortcut 1" }, { "name": "My Shortcut 2" }]
   }
   

2. open_shortcut

   • Opens a shortcut in the Shortcuts app.
   • Input:
     • name (string): Name of the shortcut to open.

3. run_shortcut

   • Runs a shortcut with optional input.
   • Input:
     • name (string): Name of the shortcut to run.
     • input (string, optional): Text input or filepath to pass to the shortcut.

Dynamic Tools

The server automatically generates additional tools for each available shortcut with:

• Tool name: run_shortcut_[sanitized_shortcut_name]
• Description: Runs the specific shortcut.
• Input:
  • input (string, optional): Text input or filepath to pass to the shortcut.

Usage with Claude

Add to your Claude configuration:

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

Implementation Details

• Uses the macOS shortcuts CLI command.
• Sanitizes shortcut names for tool naming.
• Supports direct text input and file-based input.
• Returns shortcut output when available.
• Implements standard MCP error handling.