Apple Apps Mcp

Apple MCP

Apple MCP は、AI ツールに Apple アプリへの制御されたアクセスを提供する macOS ローカルアプリおよび MCP サーバーです。

権限とクライアント設定を行う SwiftUI セットアップアプリに加え、Codex、Claude Code、Claude Desktop、Raycast など、MCP 対応アプリで利用できる TypeScript の stdio MCP サーバーが含まれています。

機能

• 連携機能の切り替えと権限の状態を確認できる、macOS ネイティブのセットアップアプリ。
• EventKit を通じたカレンダーとリマインダーへのアクセス。
• macOS のローカル自動化機能を通じた、メモ、メール、ミュージック、ショートカットのアダプター。
• stdio を使用するローカル MCP サーバー。
• Codex と Claude のクライアント設定ヘルパー。
• メールの送信、ショートカットの実行、リマインダーの完了など、リスクのある操作に対する安全対策。

MCP ツール

Apple MCP では、以下のツールを利用できます。

• apple_permissions_status
• apple_request_permission
• calendar_list_events
• calendar_create_event
• reminders_list
• reminders_create
• reminders_complete
• notes_search
• notes_read
• notes_create
• mail_search
• mail_read
• mail_create_draft
• mail_send_draft
• shortcuts_list
• shortcuts_run
• music_search
• music_play
• music_pause

リスクのあるツールを使うには、confirm: true と簡潔な reason が必要です。

ダウンロード

ビルド済みのリリースはリリースページから入手できます。

アプリは Developer ID 証明書で署名され、Apple により公証されているため、Gatekeeper の警告なしで通常どおり開けます。Apple MCP を Applications フォルダーにドラッグするだけです。

必要条件

• macOS 26 以降
• Xcode コマンドラインツール／Swift ツールチェーン
• Node.js 20 以降
• npm

ビルドと実行

npm install
npm run build
swift build
./script/build_and_run.sh

アプリはローカル設定を次の場所に保存します。

~/.apple-apps-mcp/config.json

MCP サーバーの実行

npm run dev:mcp

ビルド後、サーバーを手動で登録できます。

codex mcp add apple-apps -- node /absolute/path/to/dist/mcp/index.js
claude mcp add apple-apps -- node /absolute/path/to/dist/mcp/index.js

セットアップアプリから、対応する AI アプリのクライアント設定を書き込むことも、表示することもできます。

権限

カレンダーとリマインダーでは、ネイティブの EventKit 権限を使用します。セットアップアプリが前面での権限プロンプトを管理し、localhost のみで利用できる EventKit ブリッジを実行するため、MCP 呼び出しでも承認済みアプリのコンテキストが共有されます。

メモ、メール、ミュージック、ショートカットでは、初回使用時に macOS のオートメーション許可プロンプトが表示される場合があります。

開発

npm test
npm run build
swift build
./script/build_and_run.sh --verify

Codex アプリの「Run」ボタンは、次のコマンドを実行するように設定されています。

.codex/environments/environment.toml