Siri Shortcuts MCP Server

Name: Siri Shortcuts MCP Server
Author: dvcrn

@dvcrn

Repository

About Siri Shortcuts MCP Server

MCP for calling Siri Shorcuts from LLMs

#mcp #siri-shortcuts #llm #model-context-protocol

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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.