Apple Mail MCP

🚀 Apple Mail MCP Server

Apple Mail MCP Serverは、AIアシスタントにApple Mailへの自然言語アクセスを提供する包括的なModel Context Protocol (MCP)サーバーです。このサーバーを使用することで、Claude Desktopやその他のMCP互換クライアントを通じて、メールの閲覧、検索、整理、作成、管理が直接可能になります。

🚀 クイックスタート

Apple Mail MCP Serverを使用するには、まずインストールが必要です。インストール方法には、MCPバンドルを使用する方法と手動でインストールする方法があります。インストールが完了したら、Claudeで自然言語を使ってApple Mailと対話できます。

✨ 主な機能

📧 メールの閲覧と検索

• 受信トレイの概要：未読メール数、フォルダ構造、最近のメールが表示されるダッシュボード
• 高度な検索：複数の条件（件名、送信者、添付ファイル、読了ステータス、日付範囲）での検索
• フォルダ横断検索：すべてのメールボックスまたは特定のフォルダを対象とした検索
• メール内容：表示長を設定可能なメール内容のプレビュー
• スレッドビュー：すべてのメールボックスにまたがる会話スレッドの表示
• 最近のメール：各アカウントの最新メッセージへの迅速なアクセス

📁 メールの整理

• メールボックス管理：フォルダ階層の一覧表示とナビゲーション
• メールの移動：フォルダ間でのメッセージの移動（入れ子になったメールボックスにも対応）
• ステータスの更新：一括で読了/未読、フラグ付け/フラグ解除を行う
• ゴミ箱管理：ソフト削除、完全削除、ゴミ箱の空にする

✉️ メールの作成

• 新規メールの作成：TO、CC、BCCをサポートした新しいメールの送信
• 返信：メッセージに返信（単独または全員に返信）
• 転送：オプションでカスタムメッセージを付けてメールを転送
• 下書き管理：下書きの作成、一覧表示、送信、削除

📎 添付ファイルの処理

• 添付ファイルの一覧表示：名前とサイズを表示したすべての添付ファイルの表示
• 添付ファイルの保存：特定の添付ファイルをディスクにダウンロード

📊 分析とエクスポート

• 統計情報：包括的なメール分析（メール数、上位送信者、メールボックス分布）
• エクスポート：単一のメールまたはすべてのメールボックスをTXT/HTML形式でエクスポート

🎓 メール管理エキスパートスキル

このリポジトリには、Claudeがメール管理のエキスパートアシスタントになるための包括的なClaude Code Skillが含まれています。

スキルとは何か？

スキルは、Claude Codeの機能であり、専門知識とワークフローをパッケージ化し、ClaudeにMCPツールが何ができるかだけでなく、それを効果的に行う方法を教えます。これは、Claudeにメール管理の生産性コンサルタントを与えるようなものです。

MCP + スキル = インテリジェントなメール管理

• Apple Mail MCP（このサーバー） = ツール（18のメール機能）
• メール管理スキル (skill-email-management/) = 専門知識（ワークフロー、戦略、ベストプラクティス）

これらを組み合わせることで、機能とその最適な使用方法の両方を知っているインテリジェントなアシスタントができます。

スキルで得られるもの

📋 完全なワークフロー:

• Inbox Zero - 空の受信トレイを達成し、維持する
• 毎日のメールトリアージ - 迅速にメールを処理する（10 - 15分）
• フォルダの整理 - 構造戦略とファイリングシステム
• 高度な検索 - すぐに任意のメールを見つける
• 一括操作 - 効率的に整理とクリーンアップを行う

🧠 エキスパート知識:

• 業界標準の生産性手法（GTD、Inbox Zero）
• ツールの調整パターン（いつどのツールを使うか）
• 安全第一のアプローチ（バックアップ、制限、確認）
• 受信トレイの状態に基づくコンテキスト認識型の提案

📚 すぐに使えるリソース:

• 6つの詳細ドキュメント（3,500行以上）
• コピーアンドペースト可能なワークフローテンプレート
• 包括的な検索パターンの参照
• 一般的なシナリオと解決策

スキルのインストール

スキルはMCPと一緒に動作します。Claude Codeのユーザースコープにインストールします。

# このリポジトリをクローンする（まだしていない場合）
git clone https://github.com/patrickfreyer/apple-mail-mcp.git
cd apple-mail-mcp

# スキルをユーザースコープにインストールする（すべてのプロジェクトで利用可能）
cp -r skill-email-management ~/.claude/skills/email-management

以上です！メール管理のトピックを言及すると、スキルは自動的にアクティブ化されます。

スキルの使用方法

インストール後、Claude Codeにメール管理について尋ねるだけです。 例:

• "Inbox Zeroを達成してください"
• "受信トレイをトリアージしてください"
• "プロジェクトのメールをどのように整理すべきですか？"
• "JohnからAlphaプロジェクトに関するすべてのメールを見つけてください"
• "去年の古いメールをクリーンアップしてください"

Claudeは次のように動作します。

1. ✅ メール管理の要求を認識する
2. ✅ エキスパートワークフローとベストプラクティスを読み込む
3. ✅ MCPツールを賢く使う
4. ✅ 実行可能なステップバイステップのガイダンスを提供する

スキルの中身

skill-email-management/
├── SKILL.md                        # 核心ワークフローとツールの調整
├── examples/
│   ├── inbox-zero-workflow.md     # 完全なInbox Zeroの方法論
│   ├── email-triage.md            # 迅速な毎日のトリアージ手法
│   └── folder-organization.md     # フォルダ構造戦略
└── templates/
    ├── common-workflows.md        # コピーアンドペースト可能なワークフローパターン
    └── search-patterns.md         # 包括的な検索参照

📖 スキルの完全なドキュメントを読む →

スキル導入前後の比較

💡 プロヒント: スキルとMCPは一緒に動作するように設計されています。完全なインテリジェントなメール管理体験を得るには、両方をインストールしてください！

📦 インストール

前提条件

• Apple Mailが設定されたmacOS
• Python 3.7以上
• Apple Mailに少なくとも1つのメールアカウントが設定されていること
• Claude Desktop（MCPバンドルのインストール用）または任意のMCP互換クライアント

オプション1: MCPバンドル (.mcpb) - 推奨

インストールする最も簡単な方法は、事前にビルドされたMCPバンドルを使用することです。

1. Releasesページから最新の.mcpbファイルをダウンロードします。
2. Claude Desktopにインストールします。
   • Claude Desktopの設定を開きます。
   • Developer > MCP Serversに移動します。
   • Install from fileをクリックします。
   • ダウンロードした.mcpbファイルを選択します。
   • Claude Desktopを再起動します。
3. プロンプトが表示されたら、権限を付与します。
   • Mail.app Control
   • Mail Data Access

オプション2: 手動インストール

1. リポジトリをクローンします。

git clone https://github.com/patrickfreyer/apple-mail-mcp.git
cd apple-mail-mcp

2. 仮想環境を作成し、アクティブ化します。

python3 -m venv venv
source venv/bin/activate

3. 依存関係をインストールします。

pip install -r requirements.txt

4. ~/Library/Application Support/Claude/claude_desktop_config.jsonにClaude Desktopを設定します。

{
  "mcpServers": {
    "apple-mail": {
      "command": "/path/to/apple-mail-mcp/venv/bin/python3",
      "args": [
        "/path/to/apple-mail-mcp/apple_mail_mcp.py"
      ]
    }
  }
}

5. Claude Desktopを再起動します。

独自の.mcpbバンドルをビルドする

配布可能なMCPバンドルをビルドするには、次のコマンドを実行します。

cd apple-mail-mcpb
./build-mcpb.sh

このスクリプトは、親ディレクトリにapple-mail-mcp-v{version}.mcpbを作成します。

💻 使用例

インストールが完了したら、Claudeで自然言語を使ってApple Mailと対話できます。

メールの閲覧

受信トレイの概要を表示してください
未読メールは何通ありますか？
仕事用アカウントの最近のメールを一覧表示してください
Gmailアカウントで「プロジェクトの更新」に関するメールを検索してください
仕事用アカウントのすべてのフォルダで「請求書」に関するメールを検索してください
「会議」に関する会話スレッドを表示してください

メールの整理

件名に「請求書」が含まれるメールをアーカイブフォルダに移動してください
john@example.comからのすべてのメールを読了としてマークしてください
「期限」に関する重要なメールにフラグを付けてください
newsletter@example.comからのメールを削除してください

メールの作成と返信

「ドメイン名」に関するメールに「更新内容ありがとう！」と返信してください
仕事用アカウントからjane@example.comにメールを作成してください
「会議のメモ」に関するメールをteam@example.comに転送してください
Johnにプロジェクトの状況に関する下書きメールを作成してください

添付ファイルの管理

「請求書」に関するメールの添付ファイルを一覧表示してください
「契約書」に関するメールのPDF添付ファイルを保存してください

分析とエクスポート

過去30日間のメール統計情報を表示してください
アーカイブフォルダのすべてのメールをHTML形式でエクスポートしてください
sarah@example.comからのメールの統計情報を取得してください

利用可能なツール

MCPサーバーは20のツールを提供します。

設定

メールの設定（オプション）

メールツールを使用する際にAIアシスタントに提供する個人のメール設定を構成できます。これにより、Claudeはあなたが好むメールアカウント、デフォルト設定、ワークフローを理解することができます。

MCPバンドルのインストール (.mcpb): .mcpbバンドルを使用してインストールする場合、Claude Desktopを通じて設定を行うことができます。

1. Claude Desktopの設定を開きます。
2. Developer > MCP Serversに移動します。
3. Apple Mail MCPサーバーをクリックします。
4. Email Preferencesフィールドを設定します。

設定例:

デフォルトでBCGアカウントを使用し、最大50通のメールを表示し、アーカイブとプロジェクトフォルダを優先する

手動インストール: claude_desktop_config.jsonにenvセクションを追加します。

{
  "mcpServers": {
    "apple-mail": {
      "command": "/path/to/venv/bin/python3",
      "args": ["/path/to/apple_mail_mcp.py"],
      "env": {
        "USER_EMAIL_PREFERENCES": "Default to BCG account, show max 50 emails, prefer Archive and Projects folders"
      }
    }
  }
}

設定に含める内容:

• デフォルトのメールアカウント名（例: "BCG", "Gmail", "Personal"）
• 好みの最大メール表示数
• 頻繁に使用するメールボックス/フォルダ
• 任意のワークフロー設定

これらの設定は、すべてのツールの説明に自動的に挿入され、Claudeがあなたのワークフローに合わせたより良い判断を行うのに役立ちます。

安全制限

いくつかの操作には、誤った一括操作を防ぐための安全制限が含まれています。

• update_email_status: デフォルトの最大更新数は10
• manage_trash: デフォルトの最大削除数は5
• move_email: デフォルトの最大移動数は1

これらの制限は、必要に応じて関数パラメータを介して調整することができます。

権限

初回使用時に、macOSは権限を求めるプロンプトを表示します。

1. Mail.app Control: Mail操作を自動化するために必要
2. Mail Data Access: メール内容を読み取るために必要

完全な機能を利用するには、システム設定 > プライバシーとセキュリティ > オートメーションで両方の権限を付与してください。

🔧 技術詳細

• フレームワーク: FastMCP - Python MCPサーバーフレームワーク
• オートメーション: AppleScriptを使用したMail.appとのやり取り
• プラットフォーム: macOSのみ（Apple Mailが必要）
• Python: 3.7以上

プロジェクト構造

apple-mail-mcp/
├── apple_mail_mcp.py              # メインのMCPサーバー
├── requirements.txt               # Pythonの依存関係
├── README.md                      # このファイル
├── LICENSE                        # MITライセンス
├── CHANGELOG.md                   # バージョン履歴
├── claude_desktop_config_example.json  # 設定例
├── apple-mail-mcpb/
│   ├── manifest.json              # MCPバンドルのメタデータ
│   └── build-mcpb.sh             # バンドルのビルドスクリプト
└── skill-email-management/        # 🎓 メール管理エキスパートスキル
    ├── README.md                  # スキルのインストールと使用ガイド
    ├── SKILL.md                   # 核心ワークフローと専門知識
    ├── examples/                  # ワークフローの例
    │   ├── inbox-zero-workflow.md
    │   ├── email-triage.md
    │   └── folder-organization.md
    └── templates/                 # 再利用可能なパターン
        ├── common-workflows.md
        └── search-patterns.md

トラブルシューティング

Mail.appが応答しない場合

• Mail.appが実行中であることを確認してください。
• システム設定で権限が付与されていることを確認してください。
• Mail.appとClaude Desktopを再起動してください。

パフォーマンスが遅い場合

• メール内容の取得はメタデータよりも遅くなります。
• 内容のプレビューが必要ない場合は、include_content: falseを使用してください。
• 大規模な検索では、max_resultsを減らしてください。

メールボックスが見つからない場合

• Mail.appに表示される正確なフォルダ名を使用してください。
• 入れ子になったフォルダの場合は、/区切りを使用します。例: "Projects/Amplify Impact"
• 一部のアカウント（Exchange）は異なるメールボックス名を使用する場合があります。

権限エラーの場合

# システム設定で権限を付与する
システム設定 > プライバシーとセキュリティ > オートメーション > [あなたのターミナル/Claude]

コントリビューション

コントリビューションは大歓迎です！プルリクエストを送信してください。大きな変更の場合は、次の手順を行ってください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. プルリクエストを開きます。

ロードマップ

最近の追加機能:

• [x] ✨ ワークフローとベストプラクティスを備えたメール管理エキスパートスキル (v1.0.0)

今後検討されている機能強化:

• [ ] スマートメールボックスのサポート
• [ ] ルール/フィルター管理
• [ ] メールテンプレートシステム
• [ ] 一括操作の改善
• [ ] 高度な検索演算子
• [ ] マルチアカウント操作

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

謝辞

• Jeremiah LowinによるFastMCPを使用して構築されています。
• Model Context Protocol仕様に触発されています。
• AnthropicのClaude Desktop、MCPサポート、およびClaude Code Skillsに感謝します。
• メール管理エキスパートスキルは、MCPとスキルを組み合わせるベストプラクティスを示しています。

サポート

• 問題報告: GitHub Issues
• ディスカッション: GitHub Discussions

変更履歴

バージョン履歴とリリースノートについては、CHANGELOG.mdを参照してください。

Claude Desktopコミュニティのために❤️ で作られました