Siri Shortcuts

by dvcrn

161 stars
637 downloads
Not rated
GitHub

About

Integrates with macOS Shortcuts to dynamically expose and execute user-defined automation workflows through generated tools.

Details

Author
dvcrn
Repository
dvcrn/mcp-server-siri-shortcuts
GitHub stars
161
Downloads
637
License
GNU General Public License v3.0
Categories
Productivity, Other, Automation, AI, Developer Tools, File Management, Infrastructure

- 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
    Command (node, npx, python, etc.) npx
    Arguments
    • Argument 1 mcp-server-siri-shortcuts
    Environment
    • INJECT_SHORTCUT_LIST false
    • GENERATE_SHORTCUT_TOOLS true

    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

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.

Add to your Claude configuration:

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

list_shortcuts

Lists all available Siri shortcuts on the system. No input required. Returns an array of shortcut names.

open_shortcut

Opens a shortcut in the Shortcuts app. Input: name (string): Name of the shortcut to open.

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.

Claude Desktop / Cursor

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

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

Linux

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

Macos

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

Windows

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

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.

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

- 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" }] }

- Opens a shortcut in the Shortcuts app
- Input:

- name(string): Name of the shortcut to open

- 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

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

The server supports the following environment variables:

- GENERATE_SHORTCUT_TOOLS(default:true): When set tofalse, 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 totrue, injects the list of available shortcuts into therun_shortcuttool description to help the LLM understand which shortcuts are available.

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

- Uses the macOSshortcutsCLI 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

Let Claude control your Mac — 12 typed tools for windows, menus, keyboard, clipboard, browser tabs

Enables LLM clients to interact with macOS applications through AppleScript. Built using the @beyondbetter/bb-mcp-server library, this server provides safe, controlled execution of predefined scripts with optional support for arbitrary script execution.

Connect AI clients to Cal.com scheduling through the Model Context Protocol using the hosted server at mcp.cal.com or a local instance.

Sync Calendars, Scheduling Links, AI Executive Scheduling Assistant, Unified Calendar

Automated document processing and extraction

Create notes, search, & think with your Fabric AI workspace

Perform queries and entity operations in your Fibery workspace.

Magica is your all-in-one AI platform, offering 2500+ cutting-edge tools under a single subscription.

Turn your Make scenarios into callable tools for AI assistants.

No-code Slack MCP Client (Powered by Runbear)

Unlock MCP for your whole team in Slack with a single install.

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.