Siri Shortcuts MCP Server

by MCP-Mirror

403 downloads Not rated yet

About

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.

Explore

- 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

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Siri Shortcuts MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Add to your Claude configuration:

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

list_shortcuts

List all available Siri shortcuts

open_shortcut

Open a shortcut in the Shortcuts app

run_shortcut

Run a shortcut by name or identifier (UUID) with optional input and output parameters

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 of the shortcut to run
- input (string, optional): Text input or filepath to pass to the shortcut

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

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

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 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

Usage with Claude

Add to your Claude configuration:

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

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.