dvcrn_mcp_server_siri_shortcuts

dvcrn_mcp_server_siri_shortcuts

by dvcrn
An MCP server that enables LLMs to interact with Siri Shortcuts on macOS, allowing listing, opening, and running shortcuts.

Siri Shortcuts Integration for LLMs via MCP

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
  2. Lists all available Siri shortcuts on the system
  3. No input required
  4. Returns: Array of shortcut names

json { "shortcuts": [{ "name": "My Shortcut 1" }, { "name": "My Shortcut 2" }] }

  1. open_shortcut
  2. Opens a shortcut in the Shortcuts app

  3. Input:

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

  4. run_shortcut

  5. Runs a shortcut with optional input
  6. 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

About

MCP for calling Siri Shorcuts from LLMs

Topics

mcp siri-shortcuts llm model-context-protocol

Resources

Readme

Activity

Stars

93 stars

Watchers

3 watching

Forks

4 forks

Report repository

Releases

1 tags

Languages

Features & Capabilities

Categories
mcp_server model_context_protocol typescript javascript docker siri_shortcuts llm claude api_integration macos

Implementation Details

View on GitHub

Stats

0 Views
93 GitHub Stars

Repository Info

dvcrn Organization

Similar MCP Servers

continuedev_continue by continuedev
25049
cherryhq_cherry_studio by CherryHQ
21423
bytedance_ui_tars_desktop by bytedance
9300
2025© BestAI