このMCPサーバーは、モデルコンテキストプロトコル(MCP)を通じてSiriショートカット機能へのアクセスを提供します。macOSショートカットアプリからショートカットをリストアップ、開開、実行することが可能です。

特徴

• _すべての_ショートカットを公開するため、LLMはショートカットアプリで利用可能なものを何でも呼び出せる。
• 利用可能なすべてのショートカットを一覧表示
• ショートカットアプリでショートカットを開く
• オプションの入力パラメータを持つショートカットを実行する
• 利用可能な各ショートカットごとに動的に生成されるツール

道具

ベースツール

1. list_shortcuts

• システム上で利用可能なすべてのSiriショートカットを一覧化
• 入力不要
• リターン:ショートカット名の配列

2. open_shortcut

• ショートカットアプリでショートカットを開く
• 入力:
• name(文字列):開くショートカットの名前

3. run_shortcut

• オプション入力付きのショートカットを実行する
• 入力:
• name(文字列):実行するショートカットの名前または識別子(UUID)
• input(文字列、任意):ショートカットにパスするためのテキスト入力またはファイルパス

ダイナミックツールズ

サーバーは、以下のフォーマットで利用可能な各ショートカットに対して自動的に追加のツールを生成します:

• 工具名:run_shortcut_[sanitized_shortcut_name]
• 説明:特定のショートカットを実行します
• 入力:

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.

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 or identifier (UUID) 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

Configuration

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.

Usage with Claude

Add to your Claude configuration:

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

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