Siri Shortcuts MCP Server

What is Siri Shortcuts MCP Server?

Siri Shortcuts 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, enabling an LLM to call any shortcut available in the app.

How to use Siri Shortcuts MCP Server?

Configure it in your MCP client (e.g., Claude) by adding a JSON entry with command: "npx" and args: ["mcp-server-siri-shortcuts"]. Optionally set environment variables GENERATE_SHORTCUT_TOOLS (default true) and INJECT_SHORTCUT_LIST (default false) to control dynamic tool generation and shortcut list injection.

Key features of Siri Shortcuts MCP Server

• Lists all available Siri shortcuts on the system
• Opens a shortcut in the Shortcuts app
• Runs shortcuts with optional text input or filepath
• Automatically generates a dedicated tool per shortcut
• Uses the macOS shortcuts CLI command under the hood
• Returns shortcut output when available

Use cases of Siri Shortcuts MCP Server

• An LLM lists all available shortcuts to decide which to execute
• A shortcut is opened in the Shortcuts app for editing or inspection
• A shortcut runs automatically based on LLM reasoning, with optional input
• Dynamic tools allow direct invocation of any shortcut without manual mapping

FAQ from Siri Shortcuts MCP Server

What tools does Siri Shortcuts MCP Server provide?

It provides three base tools: list_shortcuts, open_shortcut, and run_shortcut. Additionally, if GENERATE_SHORTCUT_TOOLS is true (default), it creates a dynamic tool for each shortcut named run_shortcut_[sanitized_name].

Can I disable the dynamic shortcut tools?

Yes. Set the environment variable GENERATE_SHORTCUT_TOOLS to false. Then only the three base tools will be available.

How does the server help the LLM know which shortcuts exist?

When INJECT_SHORTCUT_LIST is set to true, the list of available shortcuts is injected into the run_shortcut tool description, helping the LLM understand which shortcuts are available.

What runtime dependencies are required?

The server runs on macOS and relies on the built-in shortcuts CLI command. No additional software is required.

How are inputs passed to shortcuts?

The run_shortcut tool accepts an optional input parameter (string). This can be text directly or a filepath, which is then passed to the shortcut.