Outlook MCP Server

🤖 Outlook MCP サーバー

Microsoft Outlook 向けの AI を活用したメール管理 - 自然言語のコマンドで、メールの検索、作成、整理、一括転送ができます。

🤔 プロジェクトの選択：ローカル方式とクラウド方式

このプロジェクトでは win32COM を使用しており、Outlook のデータをすべてローカルで処理します（より安全です）。一方、新しい Microsoft Graph MCP Server は Microsoft 365 エコシステム全体にオンラインでアクセスできます（より多機能です）。セキュリティと機能のニーズに応じて選択してください。

このプロジェクト（win32COM）を選ぶ理由

• ✅ ローカルデータ処理：メールの操作はすべてコンピューター上でローカルに行われ、データが端末の外に出ることはありません
• ✅ 強化されたセキュリティ：クラウド認証や API トークンは不要で、既存の Outlook 環境で動作します
• ✅ オフラインでの利用：インターネットに接続していなくても、メールにアクセスして管理できます
• ✅ プライバシー優先：メールデータが外部サーバーやクラウドサービスに渡ることはありません

Microsoft Graph API に切り替える理由

• ✅ Microsoft 365 エコシステム全体：メール、カレンダー、Teams、OneDrive、SharePoint にアクセスできます
• ✅ クロスプラットフォーム対応：Windows、macOS、Linux、モバイルデバイスで動作します
• ✅ 最新の認証方式：デバイスコードフローを使用した OAuth 2.0
• ✅ クラウド規模のパフォーマンス：ローカルアプリケーションへの依存はありません
• ✅ オンラインアクセス：クラウドベースの Microsoft 365 サービスと直接連携します

---

🚀 クイックスタート（2 分）

利用できる機能

• スマートなメール検索：「先週の予算承認に関するメールを探して」
• AI によるメール作成：文脈に応じた提案を使って返信の下書きを作成
• 簡単な整理：簡単なコマンドでフォルダーを作成し、メールを移動
• 一括転送：数時間ではなく数分で、何百人もの宛先にメールを送信

🤖 AI の動作とワークフロー

agent_prompt_template.md では、メール管理時の AI アシスタントの動作を定義しています。

• 目的：メールの検索、要約、下書き作成に関する AI のワークフローをガイドします
• 主なルール：検索では AND ロジックを使用、メールは 5 件ずつ表示、送信前に確認
• 安全性：組み込みの制約により、ユーザーが制御でき、許可されていない操作を防ぎます
• 使い方：テンプレートの内容をコピーし、AI アシスタントの設定に使用します

動作ガイドラインとワークフローの定義については、テンプレートを参照してください

Outlook MCP Server を選ぶ理由

機能	Outlook MCP Server	従来の Outlook	Outlook アドイン
AI メール検索	✅ 「上司からの緊急メールを探して」	❌ 手動でフォルダーを閲覧	⚠️ 基本的な検索のみ
自然言語	✅ 「先週の予算に関するメールを見せて」	❌ 複雑なフィルターが必要	⚠️ キーワードに制限あり
メールを 100 件以上一括転送	✅ CSV を使って 2 分	❌ 手動で 50 分以上	⚠️ 20 分以上
AI によるメール作成	✅ 文脈に応じた返信	❌ 手動で作成	⚠️ 基本的なテンプレート
セットアップ時間	✅ 2 分	✅ インストール済み	❌ 10～30 分
プライバシー	✅ 100% ローカル処理	✅ ローカルのみ	⚠️ クラウドに依存
費用	✅ 完全無料	✅ 付属	💰 月額 5～50 ドル
習得のしやすさ	✅ 自然言語	✅ 慣れたインターフェース	⚠️ 新しいインターフェース

実際の効果

導入前：「このメールをチームメンバー150人に転送する必要があります……」

• 手動：転送をクリック → 各メールアドレスを入力 → 送信 → 2時間以上の無駄
• 従来の Outlook：配布リストを作成 → メンバーを追加 → 転送 → 30分以上

導入後：「このメールを team.csv の全員に転送して」

• Outlook MCP Server：CSV を読み込み → AI が全員に転送 → 合計2分
• 削減できる時間：バッチ操作1回あたり48分以上！

要件

• ✅ Python 3.8+
• ✅ Microsoft Outlook 2016+（起動している必要があります）
• ✅ Windows 10+

インストールとセットアップ

方法 1：UVX（推奨 — 依存関係を自動管理）

# 1. Install
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server
uvx --with "pywin32>=226" --with-editable "." outlook-mcp-server

# 2. Configure your AI assistant
# Use this in your MCP client settings:
{
  "mcpServers": {
    "outlook": {
      "command": "uvx",
      "args": ["--with", "pywin32>=226", "--with-editable", ".", "outlook-mcp-server"]
    }
  }
}

方法 2：標準の Python

# 1. Install
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server
pip install -r requirements.txt
python -m outlook_mcp_server

# 2. Configure your AI assistant
# Use this in your MCP client settings:
{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["-m", "outlook_mcp_server"]
    }
  }
}

方法 3：ソースから直接（開発用）

# 1. Install
git clone https://github.com/marlonluo2018/outlook-mcp-server.git
cd outlook-mcp-server
pip install -r requirements.txt

# 2. Configure your AI assistant
# Use this in your MCP client settings:
{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["C:\\Project\\outlook-mcp-server\\outlook_mcp_server\\__main__.py"]
    }
  }
}

セットアップをテストする ✅

AI アシスタントに「最近のメールを表示して」と尋ねてください。動作すれば準備完了です！

設定のトラブルシューティング 🛠️

よくある問題と解決方法：

問題	確認事項	解決方法
「uvx が見つかりません」	UV はインストールされていますか？	pip install uv を実行してから再試行してください
「python が見つかりません」	Python は PATH にありますか？	C:\Python39\python.exe のようにフルパスを使用してください
「Outlook が起動していません」	Outlook のウィンドウは開いていますか？	まず Outlook を起動してから、MCP を再起動してください
「アクセスが拒否されました」	管理者権限がありますか？	ターミナルを管理者として実行してください
「モジュールが見つかりません」	依存関係はインストールされていますか？	pip install -r requirements.txt を実行してください

設定の確認：

# Test your setup before connecting to AI
python -c "import outlook_mcp_server; print('✅ Server module loaded')"

# Test Outlook connection (Windows only)
python -c "import win32com.client; outlook = win32com.client.Dispatch('Outlook.Application'); print('✅ Outlook connected')"

MCP クライアント別のセットアップ：

Claude Desktop：

1. Claude Desktop の設定を開きます
2. 「MCP Servers」セクションを探します
3. 「Add Server」→「Custom」をクリックします
4. JSON 設定を貼り付けます
5. Claude Desktop を再起動します

その他の MCP クライアント：

• 「MCP Configuration」または「Server Settings」を探します
• JSON をクライアントの設定ファイルに追加します
• 通常は ~/.config/[client]/mcp.json にあります

解決できませんか？ エラーメッセージと設定の詳細を添えて、問題を報告してください。

🎯 主な機能

メール管理

• 検索：件名、送信者、本文、日付範囲でメールを検索します
• 作成：AI の支援を受けて新しいメールを作成します
• 返信：会話の文脈を理解したスマートな返信を作成します
• 一括転送：CSV ファイルから数百人の宛先にメールを送信します（何時間も節約できます！）

フォルダー管理

• 一覧表示：Outlook のすべてのフォルダーを確認します
• 作成：簡単なコマンドで新しいフォルダーを作成します
• 移動：フォルダー間でメールを整理します
• 削除：フォルダーを削除します（注意してください。元に戻せません！）

📧 一括転送：メール配信にかかる時間を大幅に削減

実際のユースケース

🎯 チームへのお知らせ

• 週次レポートをチーム全員に転送します
• 重要なお知らせをチームメンバー全員に送信します
• プロジェクトの最新情報を関係者に配信します

📊 マーケティングキャンペーン

• ニュースレターを購読者リストに送信します
• プロモーションメールを顧客セグメントに転送します
• イベントの招待状を連絡先グループに配信します

🏢 社内コミュニケーション

• ポリシーの更新を全従業員に送信します
• トレーニング資料を各部門に転送します
• お知らせを会社の配布リストに配信します

🔄 動作の仕組み

シンプルなワークフロー

1. メールを読み込む：「最近のメールを表示して」→ メールがキャッシュに表示されます
2. 結果を確認する：1ページあたり5件のメールが、見やすく整形されて表示されます
3. 操作する：返信、移動、削除、または AI による要約を行います
4. 送信前に確認する：AI はメールを送信する前に必ず確認を求めます

AI アシスタントの動作

• 自然言語を理解：「上司からの緊急メールを探して」
• メールの要約を表示：1行の概要と主な対応事項
• 文脈を踏まえた下書き：会話の内容を理解した返信を作成します
• 許可なく送信しない：送信前に必ず確認を求めます

一括転送のワークフロー

1. CSV ファイルを準備する

email
[email protected]
[email protected]
[email protected]

2. 自然な言葉で指示する

"Forward this email to everyone in my contacts.csv"
"Send this project update to my team list"
"Distribute this newsletter to subscribers.csv"

3. あとは AI に任せる

• 大きなリストを自動的に分割します（1回あたり最大500件）
• BCC で送信し、宛先のプライバシーを保護します
• 元のメールの前にカスタムメッセージを追加します
• 配信完了を通知します

時間の節約

手動で転送する場合：メール100件 × 30秒 ＝ 50分 一括で転送する場合：設定30秒 ＋ 処理2分 ＝ 2.5分 節約できる時間：一括処理ごとに47.5分！

🔧 よく使うコマンド

AI アシスタントで次のコマンドを試してください。

"Show me emails from last 3 days"
"Find emails about project updates" 
"Draft a reply to John about rescheduling"
"Create a folder called 'Work Projects'"
"Move email #3 to the Archive folder"

🛠️ 必須ツール

メールの検索と読み込み

• list_recent_emails_tool(days=7) - 最近のメールを読み込みます（最大：30日分）
• search_email_by_subject_tool("search term") - メールの件名を検索します
• search_email_by_sender_name_tool("sender name") - 送信者で検索します
• search_email_by_body_tool("search term") - メールの内容を検索します（処理が遅くなります）

メールの操作

• view_email_cache_tool(page=1) - 読み込んだメールを閲覧します（1ページあたり5件）
• get_email_by_number_tool(email_number) - メールの詳細をすべて取得します
• reply_to_email_by_number_tool(email_number, "reply text") - メールに返信します
• compose_email_tool("[email protected]", "subject", "body") - 新しいメールを送信します

フォルダーの操作

• get_folder_list_tool() - 利用可能なフォルダーを確認するため、必ず最初に使用してください
• create_folder_tool("folder name") - 新しいフォルダーを作成します
• move_email_tool(email_number, "target folder") - メールをフォルダー間で移動します
• move_folder_tool("source", "target") - フォルダーを移動します

安全に関する注意事項

• 移動または削除する前に、必ず最初にフォルダー一覧を確認してください
• メールはキャッシュされます。操作にはキャッシュ内の番号を使用してください
• 確認なしで送信されることはありません。AI は送信前に必ず確認します

⚡ パフォーマンス

• メール100件を約2秒で読み込みます
• 検索結果をリアルタイムで表示します
• すべての処理はローカルで実行されます（データはプライベートに保たれます）

✅ 品質と信頼性

堅牢な検証システム

• 入力検証：処理前にすべてのユーザー入力を検証します
• カスタムエラーメッセージ：よくある問題について、明確で対処方法が分かるエラーメッセージを表示します
• 安全性チェック：問題が発生する前に、無効な操作を防ぎます

包括的なテスト

• 145件以上のユニットテスト：すべての機能を徹底的にテストしています
• 設定の網羅性：すべての設定と定数を検証しています
• エッジケースへの対応：特殊な入力や状況でテストしています
• 継続的な品質管理：信頼性を確保するため、変更のたびにテストを実行しています

これが意味すること

• エラーの削減：問題が発生する前に、検証によってミスを検出します
• より分かりやすいエラーメッセージ：何が問題だったのか、どう修正すればよいのかを正確に把握できます
• 信頼性の高い動作：包括的なテストにより、一貫したパフォーマンスを確保します
• 安全な操作：組み込みの保護機能により、誤ったデータ損失を防ぎます

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

• 100％ローカル処理：データがコンピューターの外部に送信されることはありません
• クラウドサービス不使用：完全にオフラインで動作します
• 設計段階から安全：既存の Outlook インストール環境を使用します

📚 お困りですか？

• AI アシスタントの設定については、エージェントプロンプトテンプレートをご確認ください
• インストール方法については、設定例をご覧ください
• 技術的な詳細については、Win32COM と Graph API の比較をお読みください
• パフォーマンスの最適化については、Win32COM API の実装ガイドをご確認ください
• 問題はGitHub リポジトリで報告してください

---