Mail MCP Bridge

🚀 Mail MCP Bridge

Mail MCP Bridgeは、Model Context Protocol (MCP) を通じてmacOS MailをAIに接続します。これにより、AIアシスタント（ClaudeやChatGPTなど）が直接macOS Mailのメールにアクセスし、分析することができます。MailからMessage-IDをコピーしてAIに貼り付けるだけで、手動でメールをエクスポートする必要はありません。

デモ: 実際の動作を見る (クリックして再生)

表示内容: MailからMessage-IDをコピー → AIがメール内容を分析

🇨🇳 中文版

🚀 クイックスタート

前提条件

• macOS 12.0以上（Mailアプリ付き）
• Python 3.9以上
• MCP互換のAIアシスタント（例: Claude Desktop）

インストール

# リポジトリをクローンする
git clone https://github.com/fatbobman/mail-mcp-bridge.git
cd mail-mcp-bridge

# MCPの依存関係をインストールする
pip3 install mcp

Claude Desktopの設定

1. 設定ファイルの場所を見つける:

   ~/Library/Application Support/Claude/claude_desktop_config.json
   

2. 設定ファイルを編集する (存在しない場合は作成):

   {
     "mcpServers": {
       "mail": {
         "command": "python3",
         "args": [
           "/path/to/mail-mcp-bridge/src/mail_mcp_server.py"
         ]
       }
     }
   }
   

   重要: /path/to/mail-mcp-bridge を実際のプロジェクトパスに置き換えてください。

   オプション: 添付ファイルの一時ディレクトリを設定する（デフォルトは /tmp/mail-mcp-attachments）:

   {
     "mcpServers": {
       "mail": {
         "command": "python3",
         "args": [
           "/path/to/mail-mcp-bridge/src/mail_mcp_server.py"
         ],
         "env": {
           "MAIL_ATTACHMENT_PATH": "/tmp"
         }
       }
     }
   }
   

3. Claude Desktopを再起動する (完全に終了してから再度開く)

Claude Codeプラグインのインストール（オプションだがおすすめ）

Mail MCPには、事前に構築されたコマンドとスキルを備えた、インテリジェントなメール分析機能を提供する Claude Codeプラグイン が含まれています。

得られる機能:

• 🎯 スマートな添付ファイル分析 - 重要な添付ファイル（請求書、契約書、税務書類など）を自動的に検出します。
• 🧵 スレッド追跡 - メール会話を通じてドキュメントの進化を追跡します。
• 🚀 3つの分析モード - トークンの使用を最適化するためのクイック/インタラクティブ/自動モードがあります。
• 📋 アクションアイテム抽出 - メール内の期限とタスクを見つけます。

インストール:

# 1. Mail MCPプラグインマーケットプレイスを追加する
/plugin marketplace add /path/to/mail-mcp-bridge/plugins

# 2. 添付ファイル分析機能をインストールする
/plugin install mail-attachment-analyzer@mail-mcp

# 3. Claude Codeを再起動する

/path/to/mail-mcp-bridge を実際のインストールパスに置き換えてください。

使用方法: インストール後、プラグインは自動的に機能します。

あなた: Analyze this email <message-id@example.com>
AI: [自動的に添付ファイルを検出し、インテリジェントに分析する]

または、手動コマンドを使用することもできます。

/mail-mcp:analyze-attachment

📖 → プラグインドキュメント

Mailのクイックアクションを設定する

Mailアプリに "Copy Message-ID" ボタンを追加します。

手順:

1. Automatorを開く (⌘ + Space を押し、"Automator" と入力)
2. 新しい クイックアクション を作成する:
   • ファイル → 新規 (⌘ + N)
   • "クイックアクション" を選択
   • ワークフローは現在の: 入力なし
   • で: Mail.app
3. シェルスクリプトを実行 アクションを追加する:
   • 左パネルで "シェルスクリプトを実行" を検索
   • ワークフローエリアにドラッグする
   • シェル: /bin/bash
4. スクリプト内容をコピーする:

   cat automator_script.sh
   

   出力全体をAutomatorのスクリプトエリアに貼り付ける
5. "Copy Message-ID" として保存する
6. (オプション) キーボードショートカットを割り当てる:
   • システム設定 → キーボード → キーボードショートカット
   • サービス → Mail → "Copy Message-ID"
   • ショートカットを追加する (例: ⌘ + ⇧ + C)

Automatorの設定例:

テストする:

1. Mailアプリを開く
2. 任意のメールを選択する
3. キーボードショートカットを押す (設定した場合)
4. Message-IDがコピーされたことを確認する音が鳴るはずです

✨ 主な機能

• 📧 直接アクセス - AIがMCPプロトコルを通じてメールを読み取ります。
• 🧵 スレッドサポート - 1つのMessage-IDで会話全体を取得します。
• 📎 添付ファイル抽出 - AI分析用にメールの添付ファイル（PDF、ドキュメント、画像など）を抽出します。
• 🎨 Claude Codeプラグイン - インテリジェントなメール分析用の事前構築コマンドとスキルが用意されています。
• ⚡ 高速 - ミリ秒レベルのクエリ応答です。
• 🎯 クリーンなテキスト - AI用に最適化されたテキスト抽出（HTMLや埋め込み画像を除外）。
• 🔒 プライバシー第一 - ローカルで実行され、メールはMacから離れることはありません。

📖 ドキュメント

基本的なワークフロー

1. Mailでメールを選択する
2. キーボードショートカットを押す (例: ⌘⇧C)
3. Message-IDをAIに貼り付ける

会話の例

単一のメールを読む:

あなた: Please analyze this email: <message-id@example.com>

AI: そのメールを読み取ります...
[AIがメール内容を読み取り、分析する]

メールスレッドを読む:

あなた: What's the full conversation for <message-id@example.com>?

AI: 会話全体を取得します...
[AIが会話内のすべてのメールを表示する]

実際のユースケース:

あなた: Please summarize all communication with our business partner,
including their requirements, promised timelines, and action items.

AI: 関連するメールスレッドを読み取り、重要な情報を抽出します...
[AIがメール内容を分析し、プロジェクトの進捗、約束事、アクションアイテムを整理する]

メールの添付ファイルを抽出する:

あなた: Extract and analyze the PDF invoice from this email: <message-id@example.com>

AI: このメールにはinvoice.pdf添付ファイル (1.2MB) があることがわかります。抽出します...
[AIが添付ファイルを抽出し、内容を分析する]

🔧 技術詳細

MCPツール

📖 → 詳細なAPIドキュメント

仕組み

┌─────────────┐
│  Mailアプリ   │ メールを選択 → Message-IDをコピー (⌘⇧C)
└──────┬──────┘
       │
       ↓ Message-ID
┌─────────────┐
│MCPサーバー   │ 1. MailのSQLiteデータベースをクエリする
│             │ 2. ROWIDで.emlxファイルを見つける
│             │ 3. メール内容を解析する
│             │ 4. プレーンテキストを抽出する
└──────┬──────┘
       │
       ↓ 構造化データ
┌─────────────┐
│ AIアシスタント│ メール内容を分析する
└─────────────┘

🔧 → 技術アーキテクチャ

🐛 トラブルシューティング

MCPサーバーが見つからない

解決策:

# claude_desktop_config.json内のパスを確認する
cat ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Claude Desktopを再起動する (完全に終了してから再度開く)

メールが見つからない

考えられる原因:

1. Message-IDの形式が正しくない（< > を含める必要があります）
2. メールがMailから削除されている
3. メールが別のMailアカウントのデータベースにある

アクセス許可が拒否された

解決策:

# スクリプトを実行可能にする
chmod +x *.py *.sh

🔒 プライバシーとセキュリティ

• ✅ ローカル処理 - すべての操作はMacでローカルに実行されます。
• ✅ 外部サーバーなし - データは外部サーバーに送信されません。
• ✅ テレメトリなし - 分析やトラッキングは行われません。
• ✅ 読み取り専用 - メールデータを読み取るだけで、変更することはありません。

📚 その他のドキュメント

• TOOLS.md - すべてのMCPツールの完全なAPIリファレンス
• ARCHITECTURE.md - 技術アーキテクチャとデータベース構造
• README_zh.md - 中文文档

📄 ライセンス

MITライセンス - 詳細は LICENSE ファイルを参照してください。

🤝 コントリビューション

コントリビューションを歓迎します！プルリクエストを送信してください。

🌟 謝辞

• MCP (Model Context Protocol) エコシステム向けに構築されました。
• メールとAIを橋渡しする必要性に触発されました。
• macOS 26 (Tahoe) 上のClaude Desktopでテストされました。

📮 連絡先

• 問題報告: https://github.com/fatbobman/mail-mcp-bridge/issues
• 作者: Fatbobman (Xu Yang)

☕ コーヒーを請く

このプロジェクトが役に立った場合は、コーヒーを請ってください！

AIコミュニティのために愛を込めて作られました