Siri Shortcuts

🚀 Siri Shortcuts MCP Server

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

✨ Features

• Exposes all shortcuts, meaning the LLM can invoke all functions available in the Shortcuts app.
• Lists all available shortcuts.
• Opens shortcuts in the Shortcuts app.
• Runs shortcuts with optional input parameters.
• Automatically generates tools for each available shortcut.

🛠️ Tools

Basic Tools

1. list_shortcuts

   • Lists all available Siri shortcuts on the system.
   • No input required.
   • Returns: An 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): The name of the shortcut to open.

3. run_shortcut

   • Runs a shortcut with optional input.
   • Input:
     • name (string): The name of the shortcut to run.
     • input (string, optional): The text or file path to pass to the shortcut.

Dynamic Tools

The server automatically generates additional tools for each available shortcut in the following format:

• Tool name: run_shortcut_[sanitized_shortcut_name]
• Description: Runs a specific shortcut.
• Input:
  • input (string, optional): The text or file path to pass to the shortcut.

💻 Usage with Claude

Add the following to your Claude configuration:

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

🔧 Technical Details

• Utilizes the macOS shortcuts command-line tool.
• Sanitizes shortcut names to comply with tool naming conventions.
• Supports text input and file path input.
• Returns shortcut output (if available).
• Implements standard MCP error handling.