mcp-server-siri-shortcuts

MCP.Pizza Chef: dvcrn

The mcp-server-siri-shortcuts is an MCP server that enables LLMs to interact with macOS Siri Shortcuts. It allows listing all available shortcuts, opening them in the Shortcuts app, and running them with optional input parameters. This server dynamically generates tools for each shortcut, providing seamless integration of Siri Shortcuts functionality into AI workflows, enhancing automation and task execution on macOS systems.

Use This MCP server To

List all available Siri Shortcuts on macOS Open specific Siri Shortcuts in the Shortcuts app Run Siri Shortcuts with custom input parameters Integrate Siri Shortcuts into AI-driven automation workflows Dynamically generate callable tools for each Siri Shortcut Automate macOS tasks using natural language commands via LLMs

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

mcp-server-siri-shortcuts FAQ

How do I list all available Siri Shortcuts using this MCP server?
Use the 'list_shortcuts' tool to retrieve an array of all Siri Shortcut names available on your macOS system.
Can I run a Siri Shortcut with input parameters?
Yes, the 'run_shortcut' tool supports optional input parameters to customize the shortcut execution.
Is it possible to open a shortcut directly in the Shortcuts app?
Yes, the 'open_shortcut' tool allows you to open any listed shortcut in the macOS Shortcuts app for editing or review.
Does this MCP server support dynamic tool generation?
Yes, it dynamically generates tools for each available Siri Shortcut, enabling direct calls from LLMs.
What platforms does this MCP server support?
It supports macOS systems with the Shortcuts app installed, enabling Siri Shortcuts integration.
Can this MCP server be used with different LLM providers?
Yes, it is provider-agnostic and works with OpenAI, Anthropic Claude, and Google Gemini models.
How secure is running shortcuts via this MCP server?
The server scopes access to only the shortcuts available on your system and requires appropriate permissions, ensuring controlled execution.
What kind of shortcuts can be accessed?
All shortcuts available in the macOS Shortcuts app can be listed, opened, and run through this MCP server.