Apple Mail MCP

Apple Mail MCP

macOS の Apple Mail 向けの、ローカルで stdio を使用するModel Context Protocolサーバーです。

ユーザーの Mac ですでに設定されている Apple Mail アプリとのみ通信します。IMAP／SMTP のパスワードは不要で、ネットワークポートも開きません。

安全性モデル

• メールボックスとメッセージのツールは、デフォルトで読み取り専用です。
• create_draft は、Apple Mail で未送信の下書きを表示します。
• send_email には user_approved: true が必要です。MCP クライアントは、ユーザーがメッセージの内容を正確に承認した後にのみ実行してください。
• マーク、フラグ設定、移動などのメッセージの変更にも user_approved: true が必要です。
• 動的コンテンツは AppleScript のソースに埋め込まず、引数として osascript に渡します。
• 書き込みを伴うすべての操作について、メタデータのみを含む JSONL 監査ログがローカルに記録されます。本文や認証情報がこのログに書き込まれることはありません。
• 承認用受信トレイと関係性のコンテキストは、以下で説明するローカル JSON データストアのみに保存されます。

MCP サーバー自体はローカルで動作します。ただし、MCP クライアントがツールの結果を AI モデルや別のサービスに送信する場合があります。メールの内容を扱うクライアントとモデルは、信頼できるものだけに接続してください。

必要条件

• Apple Mail が設定された macOS
• Node.js 20+
• ホストアプリケーション（Codex や Terminal など）が、「システム設定 → プライバシーとセキュリティ → オートメーション」で Mail を操作する権限

インストール

npm（推奨）

npm install -g @jakobf1/apple-mail-mcp

次に、インストールしたコマンドを使用して MCP クライアントを設定します。

{
  "mcpServers": {
    "apple-mail": {
      "command": "apple-mail-mcp"
    }
  }
}

ソースからインストール

git clone https://github.com/YOUR_ACCOUNT/apple-mail-mcp.git
cd apple-mail-mcp
npm install
npm run build

MCP クライアントへの追加

npm ではなくソースからインストールした場合は、stdio 経由でコンパイル済みサーバーを使用します。

{
  "mcpServers": {
    "apple-mail": {
      "command": "node",
      "args": ["/absolute/path/to/apple-mail-mcp/dist/index.js"]
    }
  }
}

設定を保存した後、MCP クライアントを再起動してください。最初の呼び出し時に、通常の macOS オートメーション権限の確認が表示されます。

送信者ポリシー（任意）

設定済みの特定の Apple Mail アドレスからのみ送信を許可するには、サーバーの起動時にカンマ区切りの許可リストを設定します。

{
  "env": {
    "APPLE_MAIL_MCP_ALLOWED_SENDERS": "[email protected]"
  }
}

書き込み操作の監査メタデータは、デフォルトで ~/.apple-mail-mcp/audit.jsonl にローカル保存されます。別のローカルパスを使用するには、APPLE_MAIL_MCP_AUDIT_LOG を設定してください。

AI を中心としたローカルワークスペース

承認用受信トレイと関係性のコンテキストは、デフォルトで ~/.apple-mail-mcp/data.json のローカル JSON ストアを共有します。ここには、キューに登録された下書きの本文と、意図的に保存した連絡先メモが含まれるため、プライベートなメールデータとして扱ってください。別のローカルパスを使用するには、APPLE_MAIL_MCP_DATA_STORE を設定してください。

APPLE_MAIL_MCP_DRY_RUN=true を設定すると送信内容は検証されますが、配信は行われません。また、APPLE_MAIL_MCP_ALLOWED_RECIPIENTS、APPLE_MAIL_MCP_ALLOWED_RECIPIENT_DOMAINS、および APPLE_MAIL_MCP_SENDING_WINDOW=09:00-18:00 のようなローカルの時間帯を使って、宛先を制限することもできます。

ツール

ツール	機能
list_accounts	設定済みの Apple Mail アカウントと送信者アドレスを一覧表示します。
list_mailboxes	アカウント内の最上位のメールボックスを一覧表示します。
list_messages	メッセージ本文を含めずに、受信トレイまたはメールボックスの概要を返します。
search_messages	送信者または件名で最近のメッセージを検索します。
get_message	設定可能な長さ制限で、ID を指定してメッセージ本文を 1 件読み取ります。
create_draft	送信されていないメッセージの作成画面を表示します。
send_email	承認済みのメッセージを Apple Mail に渡して送信します。
create_reply_draft	返信の下書き画面を表示し、Apple Mail による返信先と件名の処理を維持します。
set_message_read_status	承認済みのメッセージ 1 件を既読または未読にします。
set_message_flag_status	承認済みのメッセージ 1 件にフラグを付ける、またはフラグを外します。
move_message	承認済みのメッセージ 1 件を別のメールボックスに移動します。
get_audit_log	ローカルのメタデータのみの監査ログを読み取ります。
get_send_policy / preview_send	配信せずに、有効な送信保護策を確認または検証します。
queue_email_for_approval / list_approval_queue	提案されたメールをローカルに保存して、人による確認に回します。
approve_queued_email / discard_queued_email	明示的に承認されたキューの決定を適用します。
save_contact_context / get_contact_context	関係についての非公開メモ、トーン、約束、フォローアップ日を管理します。
get_contact_brief	保存済みの連絡先プロフィールと最近の受信トレイの概要を組み合わせます。
list_follow_up_radar	人による承認を得たフォローアップの期限が来ている連絡先を表示します。
get_work_mode / set_work_mode	受信トレイゼロ、営業フォローアップ、サポート、集中作業などの専用ポリシーを切り替えます。
save_thread_summary	ユーザーが承認したローカルのスレッド要約を、元のメッセージ ID とともに保存します。
get_daily_briefing	未読メッセージ、保留中の承認、期限が来ているフォローアップをまとめて、安全な日次アクション概要を作成します。

対象範囲と対象外

このプロジェクトはローカル環境のみで動作します。SMTP サーバーではなく、認証情報を管理せず、macOS のプライバシー確認を回避しません。意図的に、削除、添付ファイルのエクスポート、バックグラウンドでのスケジュール実行、自動送信を対象外としています。

公開とレジストリのメタデータ

パッケージは @jakobf1/apple-mail-mcp として公開されています。MCP Registry の ID は io.github.jakobfigur/apple-mail-mcp です。移植可能なインストール用メタデータについては、server.json を参照してください。

ライセンス

MIT