Apple Shortcuts

Apple Shortcuts MCP

macOS 上で Apple Shortcuts を利用するための MCP サーバーです。

ショートカットの検索、詳細確認、実行ができます。構造化された入力と出力の処理を使ってショートカットを実行します。

使用する場面

• エージェントから既存の Apple Shortcuts を起動する場合
• シェルでのオーケストレーションを使わずにローカルで自動化する場合
• オールインワンサーバーよりも小規模な範囲で利用する場合

機能

• ショートカットとフォルダーの一覧表示
• ショートカットの詳細確認
• 入力／出力を処理してショートカットを実行
• コンテキストに制約のあるクライアント向けのツール検索ヘルパー search_tools と get_tool_info
• ショートカットのリソースと実行プロンプト
• ヘルスチェックと状態確認：shortcuts_health、shortcuts_permission_guide、shortcuts_refresh_state

この Mac へのインストール

uvx apple-shortcuts-mcp

git clone https://github.com/JonathanRReed/Apple-MCPs.git
cd Apple-MCPs
uv sync --all-packages

AI エージェントへのインストール

{
  "mcpServers": {
    "apple-shortcuts": {
      "command": "uvx",
      "args": ["apple-shortcuts-mcp"],
      "env": {
        "APPLE_SHORTCUTS_MCP_SAFETY_MODE": "full_access"
      }
    }
  }
}

claude mcp add --transport stdio --scope user apple-shortcuts -- uvx apple-shortcuts-mcp

トランスポート

デフォルトかつ推奨のトランスポートは stdio です。代わりに Streamable HTTP で提供するには、APPLE_SHORTCUTS_MCP_TRANSPORT=streamable-http を設定します（APPLE_SHORTCUTS_MCP_HOST と APPLE_SHORTCUTS_MCP_PORT は任意です）。

macOS の要件

• macOS に組み込まれている shortcuts CLI が利用可能であること

起動チェックリスト

• MCP クライアントに uvx apple-shortcuts-mcp（またはクローン内の AppleShortcuts-MCP/start.sh）を追加します
• クライアントを再読み込みまたは再接続し、Shortcuts のツール群をコンテキストに読み込みます
• 最初に shortcuts_health を呼び出します
• CLI を利用できない場合は、shortcuts_permission_guide を呼び出します
• Shortcuts のカタログを変更した後に、shortcuts_refresh_state を呼び出します

プロンプトに関する注意

• tools/list は Shortcuts のすべてのツールを返します。コンテキストに制約のあるクライアントは、最初に search_tools を使い、必要な Shortcuts ツールについて get_tool_info を使うことができます。
• ユーザーが曖昧な表現でショートカットを依頼した場合は、まず利用可能なショートカットを一覧表示します。
• 実行するショートカットを確認してから、そのショートカットを実行します。

関連項目

• Apple-Tools-MCP