Mac Shortcuts — read your Mac from any agent

mac-shortcuts-mcp

あらゆる AI エージェントが Mac の情報を読み取れるようにします。 カレンダー、リマインダー、メモ、連絡先、クリップボード、位置情報、天気、再生中の曲などを、Apple ショートカット経由で読み取ります。読み取り専用、ローカルで動作し、アカウントもサーバーも不要です。

Claude Code、Claude Desktop、Cursor、Codex、その他あらゆる MCP クライアントで使えます。

npx -y mac-shortcuts-mcp setup      # install the read recipes (once)

{
  "mcpServers": {
    "mac": { "command": "npx", "args": ["-y", "mac-shortcuts-mcp"] }
  }
}

エージェントに「今週のカレンダーには何がある？」「賃貸契約についてのメモを探して」「Jane の電話番号は？」と尋ねてみてください。

これを作った理由

エージェントは Apple 純正アプリを読み取れません。アクセス権がなく、API もありません。 ショートカットなら読み取れます。 このサーバーは、そうしたアクセス権を持つ Shortcuts.app に処理を任せ、結果をテキストで返します。

仕組みはこれだけです。特別な工夫はなく、単につないでいるだけです。

できること

ツール	読み取るもの
mac_calendar	今後 N 日間の予定
mac_reminders	リマインダー。必要に応じてリストを指定
mac_notes	検索語に一致するメモと本文
mac_contacts	名前で検索した連絡先
mac_clipboard	現在のクリップボード
mac_location	住所と座標
mac_weather	この Mac がある場所の天気
mac_device	マシン名とバッテリー残量
mac_now_playing	現在再生中のトラック
mac_shortcuts_list	この Mac にあるすべてのショートカット
mac_run_shortcut	あなたが作成したショートカットを名前で実行
mac_action_catalog	ショートカットのアクションカタログを検索 — 詳細は以下を参照
mac_setup / mac_status	読み取り用レシピをインストールし、準備状況を確認

同梱のレシピは読み取り専用です。 mac_run_shortcut は、データを書き込んだりメッセージを送信したりするものも含め、インストール済みのあらゆるショートカットを実行できます。動作が不明な場合はユーザーに確認するよう、エージェントに説明していますが、読み取り専用のサンドボックスが強制されるわけではありません。

Mac から読み取ったデータには、すべて「指示ではなくデータ」というタグが付けられます。そのため、「以前の指示を無視して」と書かれたメモも、コマンドではなくテキストとしてエージェントに渡されます。

アクションカタログ

このパッケージの action-catalog.json には、539 個のショートカットアクションが記載されています。それぞれについて、受け付けるパラメーターキー、その型、ラベル、出力型、必要な権限を確認できます。

Apple はこれを公開していません。macOS 27 で実行中の WFActionRegistry から抽出しました。

これは重要です。誤ったパラメーターキーを指定してもエラーにならず、黙って無視されるため、ショートカットは自信満々に誤った答えを返すことがあります。実際に検証したところ、もっともらしいものの誤ったキーを使った複合ショートカットは、警告を出さずに 3 ではなく 0 を返しました。

キーを調べるには mac_action_catalog を使うか、JSON を直接読んでください。MIT ライセンスです。ご自由にどうぞ。

is.workflow.actions.addnewevent  — 새로운 이벤트  [harvested]
  출력: EKEvent
  권한: calendar, contacts, needs-interaction
  · WFCalendarItemTitle (text) — 제목
  · WFCalendarItemStartDate (date) — 시작일
  …

網羅状況：レジストリから収集したものが 497 個、キャッシュされた定義文字列から推定したものが 9 個、macOS に存在しないものが 33 個です（iOS 専用アクションのほか、Apple の誤記を含む、そもそもアクションではない文字列もいくつかあります）。

セットアップについて、率直に

mac-shortcuts-mcp setup を実行すると、同梱レシピにあなたの Mac で署名し、それぞれをショートカットアプリで開きます。レシピごとに 1 回、ショートカットを追加をクリックしてください。

このパッケージに含まれるのは、署名済みバイナリではなく読みやすい XML plistです。recipes/*.plist を開けば、インストールする内容をすべて確認できます。不透明なデータのインストールを求めるオープンソースツールは、本当の意味でオープンとは言えません。

--auto を渡すと、アクセシビリティ API を使ってショートカットを追加を自動でクリックします。アクセシビリティ権限が必要なため、デフォルトでは無効です。ツールがひそかにその権限を要求するべきではありません。

レシピが初めて連絡先またはカレンダーにアクセスするとき、macOS が許可を求めます。この確認はこのサーバーではなく、ショートカットに対するものです。

制限事項

Mac がスリープ中は動作しません。 プロセスが停止するため、通信相手がいません。画面ロックは問題ありません。画面をロックした状態でも 63 回中 62 回の呼び出しが成功し、ロック解除時と同じ速度であることを確認しました。本当の障壁はスリープです。

同梱のレシピはデータを読み取りますが、任意のインストール済みショートカットには副作用がある場合があります。macOS 専用です。結果は、接続したエージェントに送られます。

眠らないデバイスが必要なとき

バッグの中の Mac は応答できません。ポケットの中のスマートフォンならできます。

Askewは、ロック中の iPhoneでも同じことをします。エージェントがスマートフォン上でショートカットを実行し、画面をオフにしてポケットに入れたまま、約 3 秒で結果を受け取れます。こちらは無料ではなく、別の課題に取り組むものです。プッシュリレー、エンドツーエンド暗号化、アプリが必要です。このツールは、それらを必要としない部分を担います。

ライセンス

MIT。Issue とプルリクエストを歓迎します。

---

한국어

エージェントが Mac を読み取れるようにします。 カレンダー・リマインダー・メモ・連絡先・クリップボード・位置情報・天気を Apple ショートカットで読み取ります。読み取り専用、ローカル、アカウント不要、サーバー不要。

npx -y mac-shortcuts-mcp setup      # 읽기 레시피 설치 (처음 한 번)

エージェントがファーストパーティアプリを読み取れないのは、権限がなく、API もないからです。**ショートカットなら読み取れます。**このサーバーは処理をShortcuts.appに渡し、結果のテキストだけを受け取ります。

**基本のレシピは読み取り専用です。**ただし、mac_run_shortcutは、書き込みやメッセージ送信を含むインストール済みのショートカットも実行できます。動作がわからない場合は、まずユーザーに確認するよう指示しますが、読み取り専用を強制する隔離環境ではありません。Mac から読み取った内容はすべて、指示ではなくデータというラベルを付けて渡します。

539 種類のアクションカタログも公開しています。各アクションが受け取るパラメーターキーをまとめたもので、Apple が文書化していない値です。キーが間違っていると、エラーなく黙って無視され、間違った答えが返ってきます。実際に試して確認しました。実行は誰でもできますが、作成するにはこの一覧が必要です。

**制限事項：Mac がスリープすると何もできません。**画面ロックは問題ありません（ロック中でも 63 回中 62 回成功し、速度も同じです）。スリープが壁になります。

眠らないデバイスが必要なら、それはスマートフォンです。Askewはロック中の iPhoneでも同じことをします。画面を点灯させず、約 3 秒で結果が返ってきます。こちらは無料ではなく、別の課題に取り組むものです。プッシュリレー、エンドツーエンド暗号化、アプリが必要です。このツールは、それらを必要としない部分を担います。