Siri Shortcuts

What is mcp-server-siri-shortcuts?

mcp-server-siri-shortcuts is an MCP (Model Context Protocol) server that enables Large Language Models (LLMs) to interact with Siri Shortcuts on macOS. It exposes all available Siri Shortcuts as MCP tools, allowing LLMs to list, open, and run them programmatically.

How to use mcp-server-siri-shortcuts?

To use mcp-server-siri-shortcuts, you need to configure it within your LLM environment, such as Claude. The server can be run as a command-line process. You can configure environment variables like GENERATE_SHORTCUT_TOOLS to control the generation of dynamic shortcut tools and INJECT_SHORTCUT_LIST to inject the list of available shortcuts into the run_shortcut tool description for better LLM understanding. An example configuration for Claude is provided in the README.

Key Features of mcp-server-siri-shortcuts

• Exposes all Shortcuts: The server exposes all shortcuts available in the macOS Shortcuts app, allowing LLMs to access and utilize any existing shortcut.
• Base Tools: Provides fundamental tools like list_shortcuts (to list all available Siri shortcuts), open_shortcut (to open a shortcut in the Shortcuts app), and run_shortcut (to run a shortcut with optional input parameters).
• Dynamic Tools: Automatically generates additional tools for each available shortcut, named run_shortcut_[sanitized_shortcut_name], enabling direct execution of specific shortcuts.
• Configuration Options: Supports environment variables for customization, such as enabling/disabling dynamic tool generation and injecting shortcut lists.
• Input Flexibility: Supports both direct text input and file-based input for running shortcuts.
• Output Handling: Returns shortcut output when available.
• Error Handling: Implements standard MCP error handling.
• macOS Integration: Leverages the macOS shortcuts CLI command for underlying functionality.

Use Cases of mcp-server-siri-shortcuts

• Automated Workflows: LLMs can trigger complex macOS workflows defined as Siri Shortcuts, such as sending messages, creating reminders, or controlling smart home devices.
• Contextual Actions: LLMs can perform actions on macOS based on conversational context by dynamically running relevant Siri Shortcuts.
• Enhanced LLM Capabilities: Extends the capabilities of LLMs by giving them direct control over macOS functionalities through Siri Shortcuts.
• Personal Assistant Integration: Enables LLMs to act as more powerful personal assistants by leveraging the extensive capabilities of Siri Shortcuts.

FAQ from mcp-server-siri-shortcuts

Q: Can I disable the generation of dynamic shortcut tools? A: Yes, you can set the GENERATE_SHORTCUT_TOOLS environment variable to false to disable the generation of dynamic shortcut tools. In this case, only the base tools (list_shortcuts, open_shortcut, run_shortcut) will be available.

Q: How can I help the LLM understand which shortcuts are available? A: You can set the INJECT_SHORTCUT_LIST environment variable to true. This will inject the list of available shortcuts into the run_shortcut tool description, providing the LLM with more context.

Q: What kind of input can I pass to a shortcut? A: You can pass either text input or a filepath as input to a shortcut when using the run_shortcut tool.

Q: Does it work with all Siri Shortcuts? A: The server is designed to expose all shortcuts, meaning the LLM can call anything that is available in the Shortcuts app.

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

• Exposes all shortcuts, meaning the LLM can call anything that is 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 or identifier (UUID) 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 in the format:

• 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

Configuration

The server supports the following environment variables:

• GENERATE_SHORTCUT_TOOLS (default: true): When set to false, disables the generation of dynamic shortcut tools. Only the base tools (list_shortcuts, open_shortcut, run_shortcut) will be available.
• INJECT_SHORTCUT_LIST (default: false): When set to true, injects the list of available shortcuts into the run_shortcut tool description to help the LLM understand which shortcuts are available.

Usage with Claude

Add to your Claude configuration:

{
  "mcpServers": {
    "siri-shortcuts": {
      "command": "npx",
      "args": ["mcp-server-siri-shortcuts"],
      "env": {
        "GENERATE_SHORTCUT_TOOLS": "true",
        "INJECT_SHORTCUT_LIST": "false"
      }
    }
  }
}

Implementation Details

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