mcpField
S
Siri Shortcuts MCP Server

Siri Shortcuts MCP Server

Local
github.com/dvcrnProductivity195Updated 7w ago
Repository

About Siri Shortcuts MCP Server

Siri Shortcuts MCP Server lets an LLM list, open and run shortcuts from the macOS Shortcuts app through MCP. It suits macOS users who want MCP clients such as Claude to trigger existing local shortcuts.

Key features

  1. 01Lists all shortcuts available on the system
  2. 02Opens a named shortcut in the Shortcuts app
  3. 03Runs shortcuts with optional text or file path input
  4. 04Generates a dedicated tool for each shortcut
  5. 05Environment variables control dynamic tools and descriptions

Use cases

  1. 01Letting an LLM trigger existing macOS automation workflows
  2. 02Finding and running a shortcut through natural language requests
  3. 03Passing text or files to a shortcut for processing

MCP support

This is an MCP server that exposes base tools such as list_shortcuts, open_shortcut and run_shortcut, plus one generated tool per shortcut, to MCP clients.

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

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "siri-shortcuts": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-siri-shortcuts"
      ]
    }
  }
}
Run commandnpx -y mcp-server-siri-shortcuts

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmmcp-server-siri-shortcuts

Tools

3

Saved tool list · updated 3w ago

This tool takes no parameters.

Details

From the project README

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.

screenshot

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.