Apple Mail

Apple Mail MCP

Claude が Apple Mail のメールをすばやくローカルで読み取り、検索、整理、返信できるようにします。送信する内容は自分で管理できます。

Apple Mail MCP は、Mac の Mail アプリ用のMCPサーバーと、小さなメニューバーアプリです。Claude（Claude Code、Claude アプリ、または任意の MCP クライアント）は、何年分ものメールを数ミリ秒で検索し、スレッドを読み、返信が必要なメールを見つけ、あなたの文体で返信を下書きし、ニュースレターを整理して添付ファイルを保存できます。また、送信をクリックした後にだけメールを送信します。

あらゆるメールアカウントを AI 対応に

Apple Mail MCP を使うと、Apple Mail に追加できるあらゆるメールアカウントを、Claude やほかの MCP クライアントが利用できるようになります。iCloud、Gmail、Google Workspace、Microsoft 365、Outlook.com、Exchange、Yahoo、Fastmail、会社やホスティングプロバイダーの IMAP サーバー、さらには古い POP メールボックスにも対応します。

メールプロバイダー側に API、開発者アカウント、MCP 対応は必要ありません。通常どおり、Mail › Settings › Accounts でアカウントを追加してください。Mail が同期すると、そのアカウントでもほかのアカウントと同じツールを利用できます。検索、スレッド、返信が必要なメールの確認、下書き、承認後の送信、整理、スヌーズ、配信停止、情報抽出、真正性の確認に対応します。複数のアカウントを並行して利用でき、account を指定すると、各ツールの対象を1つのアカウントに限定できます。

パスワードは Mail とキーチェーン内に保持されます。このアプリがパスワードを参照したり、プロバイダーに接続したりすることはありません。Mail がすでにダウンロードした内容を読み取り、移動、下書きの作成、送信は Mail 自身に依頼します。

別のMailサーバーを作る理由

ほとんどのMailサーバーは、読み取りも含め、あらゆる操作でAppleScriptを使ってMailを動かしています。そのためMailはメールボックス内のメールを1通ずつ処理し、大きな受信トレイを検索すると数分かかったり、タイムアウトしたりします。その間、Mailはフリーズします。

Apple Mail MCPはMail独自のデータベースとメッセージファイルを直接読み取ります。Mailに表示されるものと同じデータを使い、変更（移動、フラグ設定、下書き、送信）を行うときだけMailとやり取りします。メールボックスのサイズに関係なく検索は高速で、Mailの動作を妨げません。ベンチマークをご覧ください。

• 大きなメールボックスでも高速：80,000件以上のメッセージを対象にした検索、スレッド、統計情報の取得が数ミリ秒で完了し、測定したほかのすべてのApple Mail MCPサーバーより高速です（ベンチマーク）。
• ローカルインデックスを使ったメッセージ本文の全文検索。約1分で構築できます。
• デフォルトで安全：返信と新規メールは下書きとして保存されます。「Ask me first」を有効にすると、クリックしない限り送信されません。一括変更にはプレビューと上限があり、完全に削除されることはありません。
• すぐ使えるスマートビュー：返信が必要なメール、返信待ちのメール、送信者の上位一覧、週次統計。
• ツールをワークフローに変える8つのClaudeスキル：トリアージ、受信トレイを空にする作業、フォローアップ、自分の文体に合わせた返信作成、ニュースレターの整理、調査、添付ファイル、週次レポート。
• パスワード不要、クラウド不要：Mailに設定されたすべてのアカウント（iCloud、Gmail、Exchange、IMAP）で動作し、すべてのデータはMac上に保存されます。

インストール

Homebrew：

brew install --cask mp-consulting/tap/apple-mail-mcp

**または、**アプリまたはClaude拡張機能を最新リリースからダウンロードしてください。

ファイル	用途
AppleMailMCP-x.y.z.dmg	サーバーを内蔵したメニューバーアプリです。承認、アクティビティ、検索インデックス、スキル、ワンクリック設定を利用できます。推奨です。
AppleMailMCP-x.y.z.mcpb	Claudeアプリ専用です。ダブルクリックすると、設定や再起動なしでサーバーをClaude拡張機能としてインストールできます。

どちらも公証済みで、Developer IDで署名されており、AppleシリコンおよびIntel Mac（macOS 14以降）で動作します。サーバーはio.github.mp-consulting/apple-mail-mcpとしてMCPレジストリにも登録されています。

次に、以下を行います。

1. Apple Mail MCPを開きます。メニューバーに封筒のアイコンが表示されます。
2. 封筒のアイコンをクリックしてClaudeタブを開き、Claude Codeおよび／またはClaudeアプリの横にあるConnectをクリックします。
   • Claude Codeではサーバーとすべてのスキルが利用でき、新しいセッションに反映されます。
   • Claudeアプリは起動時にのみサーバーを読み込みます。タブに表示されたらRestart Claudeをクリックします。スキルを使うには、SkillsリストをClaude appに切り替えてExportをクリックし、各.zipをClaude › Settings › Capabilities › Skillsにアップロードします。
3. macOSのアクセス許可を設定します（一度だけ。詳しくはアクセス許可をご覧ください）。

ターミナルから同じ設定を行うには、次のコマンドを実行します。

SERVER="/Applications/Apple Mail MCP.app/Contents/Helpers/Apple Mail MCP Server.app/Contents/MacOS/apple-mail-mcp"
"$SERVER" install        # Claude Code and the Claude app
"$SERVER" skills install # skills for Claude Code

ほかのMCPクライアントでは、/Applications/Apple Mail MCP.app/Contents/Helpers/Apple Mail MCP Server.app/Contents/MacOS/apple-mail-mcpをstdioサーバーとして実行します（Homebrewではapple-mail-mcpとしてもリンクされています）。0.6より前のバージョンでは、サーバーはApple Mail MCP.app/Contents/MacOS/apple-mail-mcpにありました。メニューバーアプリはClaude CodeとClaudeアプリの設定を新しいパスに移行しますが、ほかのクライアントでは手動で変更する必要があります。

アクセス許可

macOSでは、サーバーを起動するアプリ（Claude、ターミナル、VS Codeなど）に対して、次の2つのアクセス許可を求められます。

アクセス許可	理由	場所
フルディスクアクセス	Mailのデータベースとメッセージファイルを読み取るため	システム設定 › プライバシーとセキュリティ › フルディスクアクセス
オートメーション › Mail	メールの移動、フラグ設定、下書き、送信を行うため（初回に確認されます）	システム設定 › プライバシーとセキュリティ › オートメーション

パネルの件数表示と検索インデックスのため、Apple Mail MCPにもフルディスクアクセスを許可してください。何かが不足している場合、各ツールは許可が必要なアプリを正確に示し、パネルでは要対応に表示されます。完全なチェックを行うには、apple-mail-mcp doctorを実行してください。

Claude でできること

ツール	機能
inbox_overview	未読件数、最新の未読メール、返信が必要なメール、フラグ付きメールを1回の呼び出しで確認します
search_messages	テキスト（複数の候補）、件名、差出人、宛先、本文、メールボックス、アカウント、日付、未読、フラグ、Mail のカテゴリを自由に組み合わせて検索します。件名、差出人、返信、自分自身を除外でき、direction（受信または送信）も指定できます。ページ分割表示のほか、group_by で差出人、ドメイン、月ごとの件数を集計できます
export_search	検索に一致するすべてのメールを1つの CSV、JSON または XLSX ファイルにエクスポートします。請求書の合計額と番号も必要に応じて含められます。パスと行数のみを返します
get_message、get_messages、get_thread	1件のメール、最大200件のメール、または会話全体を取得します。リクエストに応じて引用部分を除去します
extract_invoice_fields	請求書や領収書の本文および添付 PDF から、販売元、請求書番号、合計額、通貨を抽出します
extract_fields	追跡番号（配送業者を含む）、確認コード、予約番号や注文番号、フライト、カレンダーの招待を抽出します
check_authenticity	メールが表示どおりの差出人から送られたものかを確認します。SPF、DKIM、DMARC、類似ドメイン、偽装された名前、偽装リンクをチェックします
find_contact	連絡先およびメールをやり取りしている相手のアドレスを、頻度の高い順に表示します
wait_for_mail	条件に一致するメール（サインインコードや返信の予定など）が届くまで待ち、届いたメールを返します
mail_setup	Mail のルール、VIP、スマートメールボックス、署名を確認します
create_rule、update_rule、set_rule_enabled、delete_rule	Mail のルールを作成、変更、有効化・無効化、削除します（転送、返信、削除は事前に確認を求めます）。各操作は Mail に保存されたルールと照合され、undo_change で取り消せます
apply_rules	「メッセージ」›「ルールを適用」と同様に、メールボックス内の既存メールにルールを適用します。ドライランでは各ルールの動作を確認できます
needs_response	相手からあなた宛てに届き、まだ返信していないメールを表示します（メーリングリスト、プロモーション、no-reply は除外）
awaiting_reply	送信したものの、返信がないメールを表示します
mail_statistics、top_senders	メールの量、最も多い曜日と時間帯、カテゴリ、メールを最も多く送っている相手を表示します
list_accounts、list_mailboxes	アカウント、フォルダ、件数を表示します
list_attachments、save_attachment、export_messages	添付ファイルをディスクに保存し、メールを .eml または Markdown 形式でエクスポートします
get_message_source	認証や配信停止リンクの確認などに使う生ヘッダーを取得します
move_messages、update_messages、trash_messages、create_mailbox	アーカイブと振り分け、既読・未読とフラグの変更、ゴミ箱への移動を行います。dry_run でプレビューできます
undo_change	最近の移動、ゴミ箱への移動、フラグやルールの変更を一覧表示し、元に戻します
snooze_messages、list_scheduled、cancel_scheduled	指定した日までメールを非表示にし、その後未読のまま受信トレイに戻します。スヌーズや予約送信の確認・キャンセルもできます
compose_email、reply_to_message、forward_message	下書き（デフォルト）、レビュー用に開く、送信、または予約送信（send_at）を行います。プレーンテキストまたは書式付き HTML に対応します（返信と転送では、元のメールを書式付きで引用します）
list_drafts、send_draft	宛先付きの未送信下書きを表示し、下書きの内容をそのまま送信します
unsubscribe	メーリングリストの配信を停止します。署名付き送信者のワンクリック停止、配信停止メールの送信、またはリンクを開く方法に対応します
open_in_mail、check_new_mail、body_index	Mail でメールを表示し、新着メールを取得し、検索インデックスを管理します

メッセージ ID は Mail 独自のものです。移動したメッセージには新しい ID が割り当てられ、その ID は move_messages が返します。

スキルは MCP プロンプトとしても提供されています（Claude Code では /mcp__apple-mail__mail-triage など）。また、2つのリソース mail://inbox/unread と mail://needs-response は、メールに変更があると登録済みクライアントに通知します。 スヌーズと予約送信はメニューバーアプリが実行するため、アプリを起動しておく必要があります。

スキル

パネルの Claude タブで選択できます。それぞれのスキルの機能と、インストール済みかどうかが表示されます。

スキル	または、こう頼んでみましょう…
/mail-triage	「今日、メールで対応が必要なことは何ですか？」
/mail-inbox-zero	「受信トレイを空にするのを手伝ってください。」
/mail-follow-up	「今週、まだ返信していない人は誰ですか？」
/mail-reply-writer	「ロードマップについてのAnnaのメールに返信してください。」
/mail-newsletter-cleanup	「ニュースレターが多すぎるので、整理してください。」
/mail-research	「ホテルの予約確認コードを探してください。」
/mail-attachments	「2025年の請求書をすべてDocuments/Invoicesに保存してください。」
/mail-weekly-report	「メールでの今週の状況はどうでしたか？」

Claudeは依頼に応じて適切なスキルを選びます。Claude Codeでは、スラッシュコマンドでスキルを起動することもできます。 Claudeアプリでは、アップロード後にスキルが自動的に使用されます。

スキルにもサーバーと同じルールが適用されます。送信前に下書きを作成し、一括変更の前にプレビューを表示し、 メールの引用はできるだけ少なくします。アプリの更新時に、インストール済みのスキルも更新されます。

操作の決定権はあなたにあります

Claudeがメールを送信しようとすると、小さなウィンドウがポップアップします（パネルの Mail タブには件数が表示されます）。複数の メールが待機している場合は、1通ずつ確認できます。Send をクリックしない限り、メールは送信されません。

• 送信ポリシー（Settings）：Ask me first（デフォルト）では、送信する各メール（宛先、件名、 本文、添付ファイル）が表示され、Send または Don't Send を選べます。また、メニューバーアプリが起動していないと 送信できません。ほかに、Send right away または Never send（下書きのみ）を選べます。
• 署名付き承認：回答と予約送信にはKeychain内のキーで署名するため、別のプログラムがファイルを書き込んで送信を 承認することはできません。
• デフォルトでは下書き：Claudeに送信を依頼しない限り、新規作成、返信、転送はDraftsに保存されます。
• 一括処理の上限：デフォルトでは、1回の変更につき最大50件のメッセージを処理します。dry_run で移動やゴミ箱への移動をプレビューできます。必要に応じて、 指定した件数を超える移動やゴミ箱への移動は、メニューバーアプリでの承認待ちにできます。
• 元に戻す：移動、ゴミ箱への移動、フラグの変更はすべて undo_change で元に戻せます（操作履歴にはMessage-IDとメールボックス名のみが保存され、 所有者だけがアクセスできます）。
• 配信停止は送信ポリシーに従います。Ask me first を選んだ場合は、毎回確認が必要です。ワンクリックの配信停止リクエストは、 DKIM署名が自社ドメインで検証された送信者にのみ送信されます。それ以外の場合は、リンクが表示されます。
• 完全削除はしません：ゴミ箱に移動するだけで、空にすることはありません。
• ファイル：保存した添付ファイルを、起動用、設定用、システム用のフォルダーに保存することはできません。秘密情報（~/.ssh、.env、 キーチェーン、ブラウザープロファイル、Mail自体のデータ）を添付することもできません。Settingsで許可リストを設定することもできます。
• 読み取り専用モード：apple-mail-mcp --read-only では、読み取り用ツールのみが使用できます。
• アクティビティ：すべてのツール呼び出しがMailタブに表示されます（メッセージの内容は表示されません）。
• 本文を保存しない検索インデックス：Mailのデータはフルディスクアクセスで保護されていますが、~/Library/Application Support/apple-mail-mcp にある本文インデックスは保護されていません。そのため、単語は保存せず、キー付きハッシュのみを保存します（順序や位置情報は含まれません）。キー（「Apple Mail MCP search index key」）はKeychainに保存され、アプリとそのサーバーだけが利用できるアクセスグループに属します（サーバーを単独で実行するClaude拡張機能は、ログインKeychainにキーを保存します）。そのため、別のアプリがインデックスを利用することはできず、キーを持っていても推測した単語を照合できるだけです。ファイルへのアクセスは所有者のみに制限され、Time Machineの対象外です。キーが見つからない場合やアクセスが拒否された場合は、本文検索時にメッセージをスキャンします。

ベンチマーク

MCP レジストリにあるすべての Apple Mail MCP サーバーに、クライアントから見える状態と同じく MCP stdio 経由で同じ質問を行いました。Apple M1（16 GB）、実際のメールボックス（アカウント内のメッセージ数 80,551 件、受信トレイ内 1,336 件）、バージョン 0.6.0 で測定しています。各サーバーについて、ウォーム状態で 25 回実行した際の中央値です。Mail のファイルを読み取るサーバーは、各ラウンドで交互に 1 回ずつ呼び出しているため、マシンの負荷変動の影響はすべて同じように受けます。応答サイズを含む完全な表はこちらです： Benchmarks/compare-mcp-servers.md。

質問	Apple Mail MCP	mgcrea 1.28.0	imdinu 0.5.0	parasxos 1.8.0
アカウント一覧	0.4 ms	0.5 ms	1.8 ms	–
メールボックスごとの未読数	2.1 ms	7.05 s	258 ms	76 ms
受信トレイの最新 20 件	2.8 ms	2.85 s	20 ms	104 ms
件名検索、受信トレイ	1.2 ms	31 ms	18 ms	139 ms
件名検索、すべてのメールボックス	3.4 ms	6.8 s	24 ms	258 ms
送信者検索、受信トレイ	2.8 ms	3.5 s	23 ms	78 ms
本文テキスト検索、受信トレイ	2.1 ms	1.17 s	6.5 ms	112 ms
会話スレッド	3.3 ms	29 ms	–	13 ms
送信者上位、30 日間	1.9 ms	3.1 ms	–	–
統計・返信待ち・返信が必要・概要	1.1–11 ms	–	–	–

–：その質問に対応するツールがありません。

AppleScript で Mail を操作するサーバーを同じ方法で測定した場合（0.6.0、各サーバーで各質問につき 1 回、Benchmarks/compare-servers.md）、Apple Mail MCP がミリ秒で処理するところに数秒かかり、その間 Mail は使用中の状態になります。ipsupport-llc 1.6.1 の応答時間は 0.17～11 s、Python 版の mcp-apple-mail は 8～84 s でした。このメールボックスでは jakobfigur 0.6.2 と jayvee6 0.1.0 は失敗し、kiki830621 2.0.1 は 3 分後にタイムアウトしました。また、ほかのサーバーが回答できなかった質問は、Mail 内でタイムアウトするかエラーになりました。Apple Mail MCP は 13 件すべてに 0.8～17 ms で回答しました。

本文インデックスがない場合、本文検索は代わりに最近のメッセージを並列でスキャンします（ここでは 27 ms）。メールボックス全体のインデックス作成には約 1 分かかります。

再現方法：Scripts/bench-servers.sh は、ほかのサーバーを取得して準備します（バージョンを固定し、リリースファイルをレジストリの SHA-256 と照合）。その後、mail-bench compare を実行します。--fresh-index を指定すると、実行が Keychain のプロンプトで停止しないように、当サーバー用の使い捨てインデックスが作成されます。mail-bench store ではお使いのメールを対象にプロセス内での処理時間を測定でき、mail-bench synthetic --messages 100000 では個人データを含まない生成メールボックスを使って測定できます。CI ではプッシュのたびに合成データのベンチマークを実行します。

コマンドライン

apple-mail-mcp [--read-only] [--write-dir DIR] [--attach-dir DIR]   serve MCP over stdio
apple-mail-mcp doctor                                               check permissions, data, index
apple-mail-mcp index [--rebuild] [--prune]                          build or update the body index
apple-mail-mcp install | uninstall [claude-code | claude-desktop]   register with Claude
apple-mail-mcp skills [list | install | uninstall | export DIR]     manage the Claude skills
apple-mail-mcp call <tool> '{"json": "arguments"}'                  run one tool

設定は ~/Library/Application Support/apple-mail-mcp/settings.json に保存され、アプリとすべてのサーバーで共有されます（変更は即座に反映されます）。

動作の仕組み

Claude ──MCP (stdio)──▶ apple-mail-mcp ─┬─ reads ──▶ ~/Library/Mail/V10/MailData/Envelope Index (SQLite, read-only)
                                        │            .emlx files · local hashed full-text index (FTS5)
                                        └─ writes ─▶ Apple Events ─▶ Mail.app ─▶ your accounts
Apple Mail MCP.app (menu bar) ── settings · approvals · activity · index updates · Claude setup · updates

• MailStore は Mail のインデックス（アカウント、メールボックス、Gmail ラベル、フラグ、カテゴリ、スレッド）を読み取り、Mail を起動せずにメッセージを解析します（MIME、文字コード、HTML からテキストへの変換）。
• MailAutomation は Mail のスクリプティング辞書を基に Apple Events を送信します（AppleScript は使用しません）。メッセージは ID で指定し、プロセス間で順番に処理します。
• MailMCPKit はツール、ポリシー、承認、スキルを定義します。MailMCPBar は SwiftUI 製のメニューバーアプリです（macOS 26 の Liquid Glass）。

開発

git clone https://github.com/mp-consulting/apple-mail-mcp && cd apple-mail-mcp
swift test --scratch-path ~/Library/Caches/apple-mail-mcp-build   # 120+ tests on synthetic mailboxes
Scripts/build-app.sh --install                                     # build, sign, install, launch the app

アプリには Xcode 26（Swift 6.2）が必要です。サーバーは Swift 6.1 でビルドできます。アーキテクチャと、コードが依存する Mail 固有の動作については CLAUDE.md を、リリース情報については CHANGELOG.md を参照してください。

クレジット

patrickfreyer/apple-mail-mcp に着想を得ています。そのツールセットとパスガードのルールが、このプロジェクトの設計に影響を与えました。

ライセンス

MIT © 2026 Mickael Palma。Apple とは提携していません。Apple Mail は Apple Inc. の商標です。