Apple Mail, Calendar & Notes

Apple Mail、Calendar、Notes MCP

Mac にすでにインストールされている Mail、Calendar、Notes アプリを使って、AI アシスタントがメールの閲覧、検索、仕分け、送信、カレンダーの管理、メモの保存を行えるようにします。
あらゆる MCP クライアントで動作します。

最新リリースをダウンロード · インストール · できること · よくある質問

これが作られた理由

多くの AI メール連携ツールはクラウド上で動作し、Gmail または Outlook でしか使えません。メールが Apple Mail（セルフホストの IMAP サーバー、iCloud、会社のアカウントなど）にある場合、アシスタントにアクセスさせる簡単な方法がありませんでした。

この MCP サーバーは、Mac 上のアプリと直接通信します。つまり、次のことができます。

• あらゆる MCP クライアントに対応。 デスクトップチャットアプリ、ローカルモデルアプリ、コーディングエージェントなど、stdio 経由で MCP サーバーを起動できるものなら何でも使えます。
• Apple Mail で開けるアカウントなら何でも使えます。 セルフホスト、iCloud、Exchange、IMAP 経由の Gmail など、Mail.app に表示されるアカウントなら、アシスタントから確認できます。
• インストール不要。 Node、Python、Homebrew は必要ありません。すべての Mac に付属する JavaScript for Automation 上で動作します。
• メールは Mac 上に保管されます。 サーバーにネットワーク関連のコードはありません。アシスタントには要求した内容だけが表示されます。その後の送信先はモデルによって異なります（ローカルモデルならすべて Mac 上に保管されます）。
• 権限確認は 30 回ではなく 2 回です。 すべての操作は read ツールと write ツールにまとめられています。read を一度承認すれば、あとは気にする必要はありません。
• 小型のローカルモデルでも動作します。 引数の指定には柔軟に対応し（"true"、"3 days ago"、mailbox の代わりに folder）、間違いがあれば行き詰まるのではなく、修正方法を平易な言葉で示します。

できること

自然な言葉で、「返信が必要なメールはある？」「プリンターの請求書を経理に転送して」「火曜日の午後 1 時に Sam との通話を予定して」「契約メールの PDF を保存して」のように頼めます。内部では、次の操作を行います。

📥 仕分け — 「対応が必要なものは？」

🔎 閲覧と検索

✉️ 作成

🗂 整理

📅 カレンダー

📝 メモ

インストール

macOS 14 以降（それ以前のバージョンでも動作する可能性がありますが、テストはしていません）と MCP クライアントが必要です。

すべての MCP クライアント

コードを取得し、git clone https://github.com/ipsupport-llc/apple-mail-mcp を実行するか、最新リリースから .mcpb を解凍して、クライアントの設定にサーバーを追加します。Mac 自体の osascript 上で実行されます。

{
  "mcpServers": {
    "apple-mail": {
      "command": "/usr/bin/osascript",
      "args": ["-l", "JavaScript", "/path/to/apple-mail-mcp/server/apple-mail-mcp.js"]
    }
  }
}

./install.sh --print を実行すると、適切なパスを含むこのブロックが出力されます。このサーバーは、MCP Registry（https://registry.modelcontextprotocol.io）にも io.github.ipsupport-llc/apple-mail-mcp として登録されています。

アシスタントが初めて Mail、Calendar、または Notes を操作するとき、macOS からクライアントによる操作を許可するかどうか確認されます。許可をクリックしてください。

Claude Desktop（ワンクリック）

1. 最新リリースから apple-mail-mcp.mcpb をダウンロードします。
2. ダブルクリックして、インストールをクリックします。

アップデート、設定、削除は 設定 → 機能拡張 から行えます。

設定

サーバーの env に環境変数として設定します（Claude Desktop の場合：設定 → 機能拡張 → Apple Mail, Calendar & Notes → 設定）。

ツールの権限

ほとんどのクライアントでは、ツールの使用前に確認を求められます。read は一度許可し、write は毎回承認することをおすすめします。これにより、何が送信、移動、削除されるかを常に確認できます。

安全性

• メールやメモが完全に削除されることはありません。 メールはアカウントのゴミ箱へ、メモは「最近削除した項目」へ移動します。それができない場合（ゴミ箱のないアカウント、「最近削除した項目」のないメモアカウント（Exchange など）、すでにゴミ箱にある項目、ロックされたメモ）は、拡張機能が操作を拒否し、その理由を伝えます。メールを削除するルールは、すべてのアカウントで削除したメールがゴミ箱に残る場合に限り許可されます。
• macOS ではカレンダーのイベントやルールにゴミ箱がありません。 削除すると完全なコピーが返されるため、要求に応じて再作成できます。
• 返信と転送は、デフォルトでは下書きになります。 Mail で実物を確認してから、ご自身で 送信 を押します。dry_run: true を指定すると、送信される内容（宛先（Reply-To と全員に返信を含む）、件名、全文）が正確に表示されます。また、Mail の宛先設定が異なる場合、返信は送信されません。送信結果には、Mail が実際に送信した内容が記載されます。
• 処理がハングすることはありません。 Mail、Calendar、Notes は独立したワーカープロセスから操作します。タイムアウトを超えた呼び出しは明確なエラーとともに停止し、ping と tools/list は常に応答し、キャンセルした呼び出しは実際に停止します。タイムアウトした書き込みをむやみに再実行することはありません。各呼び出しは、アプリ名と所要時間とともに stderr に記録されます。
• 権限の説明。 Automation 権限がない場合、アプリが起動していない場合、または接続が失われた場合は、エラーコードではなく、わかりやすい対処方法が表示されます。
• 誤って繰り返し実行することはありません。 同じ送信、返信、削除、作成の呼び出しが 15 分以内に 2 回行われると、拒否されます。応答しなくなったモデルがメールを 5 回送信することはありません。
• 繰り返しイベントは、明示的に指定した場合にのみ削除されます。 1 つ削除するとシリーズ全体が削除されるため、拡張機能は whole_series: true を要求します。
• ドライラン。 一括移動や一括削除は、実行前にプレビューできます。
• 添付ファイルの保存場所は 1 か所に限定されます。 設定で指定した添付ファイルフォルダー内にのみ保存され、既存のファイルが上書きされることはありません。既存のファイルがある場合は (1)、(2)…が追加されます。送信メールに添付するファイルも、そのフォルダーからのみ選択できます。そのため、「attach ~/.ssh/id_rsa」のような操作は拒否されます。他のツール（たとえば Seafile のダウンロード）からのファイルは、まずそのフォルダーに保存してください。
• 添付ファイルは確認されます。 Mail がすべてのファイルを受け取らなかった場合、メッセージは送信されず、代わりに下書きとして開きます。
• メールに隠された指示に注意してください。 アシスタントが読み取る内容はすべてコンテキストの一部となるため、悪意のあるメールが何かを実行するよう指示してくる可能性があります。気になる場合は、write を手動承認のままにするか、読み取り専用モードを有効にしてください。
• 読みやすいファイルは 1 つだけです。 サーバー全体は server/apple-mail-mcp.js にあり、依存関係もネットワーク呼び出しもありません。

よくある質問

Mac がスリープ中でも Mail のルールは実行されますか？ いいえ。Apple Mail のルールは、Mail が開いている間に新着メールに対してのみ実行されます。古いメールを整理するには、アシスタントに移動を依頼してください。メールサーバーが Sieve をサポートしている場合は、サーバー側のフィルターのほうがデバイス間で安定して動作します。

アシスタントがメモを読み取れません。 おそらくロックされています。まず Notes でロックを解除してください。ロックされたメモは非公開のままです。

検索が遅いです。 Apple Mail のスクリプト処理は、非常に大きなフォルダーでは遅く、メッセージ本文の検索が最も遅くなります。アカウント、フォルダー、または日付範囲を絞り込んでください。

ツールが表示されません。 クライアントでサーバーが有効になっていることを確認してから、クライアントを再起動してください。./test.sh はクライアントを介さず、サーバーに直接接続します。（Claude Desktop：Settings → Extensions、ログの場所：~/Library/Logs/Claude/。）

「Not authorized to send Apple events」と表示されます。 System Settings → Privacy & Security → Automation を開き、MCP クライアント（サーバーを起動するアプリ）に Mail、Calendar、Notes の操作を許可してください。

git clone https://github.com/ipsupport-llc/apple-mail-mcp.git ~/code/apple-mail-mcp
cd ~/code/apple-mail-mcp
./install.sh --print   # any client: prints the config block to paste
./install.sh     # Claude Desktop: adds an "apple-mail" entry to claude_desktop_config.json (backs it up first)
./test.sh        # talks to the server directly and prints your accounts and calendars
./uninstall.sh   # removes the entry

/usr/bin/osascript -l JavaScript tests/unit.js server/apple-mail-mcp.js
python3 tests/protocol.py

git tag v1.4.0 && git push origin v1.4.0

ライセンス

MIT © IPSupport LLC。一部の機能のアイデアは patrickfreyer/apple-mail-mcp（MIT）から着想を得ています。