Overview

This MCP server exposes every macOS Shortcut as an MCP (Model Context Protocol) tool so you can discover, inspect, and trigger Shortcuts programmatically. It runs locally on macOS and translates MCP tool invocations into calls to the Shortcuts runtime on the host. The result is a simple bridge that lets automation systems, LLM agents, or remote controllers treat Shortcuts like first-class tools.

Using an MCP surface means your LLM-driven flows or automation orchestrators can list available Shortcuts, read their argument schemas (when available), and execute them with structured inputs — all over a minimal HTTP/JSON API. That makes it easy to integrate existing Shortcuts into larger automation pipelines or to expose Shortcuts to remote trigger systems while keeping execution on the macOS device.

Features

Automatically expose every macOS Shortcut as an MCP tool
List tools with names, identifiers and input metadata
Invoke a Shortcut by name or ID with structured inputs
Return Shortcut output and execution status to the caller
Token-based authentication and optional TLS
Lightweight local server designed for macOS Shortcuts CLI/backing runtime
Simple JSON endpoints suitable for MCP client integrations and LLM agents

Installation / Configuration

Prerequisites:

macOS with Shortcuts available (macOS Ventura or later recommended)
Git and a build/runtime toolchain for the project (see repository for language-specific build steps)

Clone and run (example):

# Clone the repository
git clone https://github.com/dvcrn/mcp-server-siri-shortcuts.git
cd mcp-server-siri-shortcuts

# Build or run per the project instructions; many implementations provide a single executable
# Example: if the project builds to a binary `mcp-siri-shortcuts`
./mcp-siri-shortcuts --port 8080 --token "replace_with_secure_token"

Configuration via environment variables (example):

export MCP_PORT=8080
export MCP_TOKEN="replace_with_secure_token"
export MCP_TLS_CERT="/path/to/cert.pem"   # optional
export MCP_TLS_KEY="/path/to/key.pem"     # optional
./mcp-siri-shortcuts

Example JSON configuration file (example/config.json):

{
  "port": 8080,
  "auth_token": "replace_with_secure_token",
  "tls": {
    "cert_path": "/path/to/cert.pem",
    "key_path": "/path/to/key.pem"
  }
}

Notes on macOS permissions:

The server invokes the Shortcuts runtime (often via the shortcuts command-line tool). When prompted, allow the server to control the Shortcuts app and any other apps the Shortcuts use.
Grant Accessibility or Automation permissions if macOS requests them for the server binary or terminal app you use to run it.

Available Tools / Resources

The server maps each Shortcut to an MCP tool. Each tool typically exposes:

id: internal identifier (stable across server restarts unless you change the Shortcut)
name: human-readable name (the Shortcut’s name)
description: if available from Shortcut metadata
inputs: list of named parameters (type information may vary)
run endpoint: server-side entry point to execute this Shortcut

You can list tools:

curl -H "Authorization: Bearer replace_with_secure_token" \
  http://localhost:8080/mcp/tools

Sample response (abridged):

[
  {
    "id": "open-garage",
    "name": "Open Garage",
    "description": "Triggers the garage opener via HomeKit.",
    "inputs": [
      { "name": "force", "type": "boolean", "required": false }
    ]
  },
  {
    "id": "daily-summary",
    "name": "Daily Summary",
    "description": "Generates today's summary and returns a text report.",
    "inputs": [
      { "name": "includeWeather", "type": "boolean", "required": false }
    ]
  }
]

Invoke a tool:

curl -X POST -H "Authorization: Bearer replace_with_secure_token" \
  -H "Content-Type: application/json" \
  -d '{"tool_id":"daily-summary","args":{"includeWeather":true}}' \
  http://localhost:8080/mcp/run

Example response:

{
  "status": "ok",
  "exit_code": 0,
  "output

Siri Shortcuts MCP Server for macOS

Overview

Features

Installation / Configuration

Available Tools / Resources