Outlook MCP Server Main

🚀 Outlook MCP サーバー

このサーバーは、Microsoft Outlook のメール機能へのアクセスを提供する Model Context Protocol (MCP) サーバーです。大規模言語モデルやその他の MCP クライアントが、標準化されたインターフェースを通じてメールの読み取り、検索、管理を行うことを可能にします。

✨ 主な機能

• フォルダ管理：Outlook クライアントのすべての利用可能なメールフォルダを一覧表示します。
• メール一覧：指定された期間内のメールを検索します。
• メール検索：連絡先の名前、キーワード、またはフレーズ（OR 演算子をサポート）でメールを検索します。
• メール詳細情報：添付ファイルを含む完全なメール内容を表示します。
• メール作成：新しいメールを作成して送信します。
• メール返信：既存のメールに返信します。

📦 インストール

前提条件

• Windows オペレーティングシステム
• Python 3.11 以上
• Microsoft Outlook がインストールされ、アクティブなアカウントが設定されていること
• Claude Desktop またはその他の MCP 互換クライアント

インストール手順

1. このリポジトリをクローンまたはダウンロードします。
2. 必要な依存関係をインストールします。

pip install mcp>=1.2.0 pywin32>=305

3. Claude Desktop（またはその他の MCP クライアント）を設定して、このサーバーを自動的に起動するようにします。

💻 使用例

MCP クライアントの設定に以下の内容を追加します。

{
  "mcpServers": {
    "outlook": {
      "isActive": true,
      "name": "outlook",
      "description": "Outlook ツール",
      "command": "python",
      "args": [
        "${workspaceFolder}/outlook_mcp_server.py"
      ]
    }
  }
}

利用可能なツール

このサーバーは以下のツールとその詳細な機能を提供します。

1. list_folders：
   • Outlook 内のすべての利用可能なメールフォルダを一覧表示します。
   • フォルダの階層構造を最大3階層まで表示します。
   • フォルダとサブフォルダの形式付きリストを返します。
2. list_recent_emails：
   • 指定された日数（1 - 30日）内のメールの件名を一覧表示します。
   • 検索するフォルダを指定できます（デフォルトは受信トレイ）。
   • 結果をキャッシュして詳細を確認しやすくします。
   • 見つかったメールの数とそれらを表示する方法の説明を返します。
3. search_emails：
   • 連絡先の名前またはキーワードでメールを検索します。
   • 複数の検索語に OR 演算子をサポートします。
   • 件名、差出人の名前、本文内容を検索します。
   • 一致する項目の数とそれらを表示する方法の説明を返します。
4. view_email_cache：
   • キャッシュされたメールをページごとに5件ずつ閲覧します。
   • メールの件名、差出人、受信日時、既読状態を表示します。
   • 前のページ/次のページのナビゲーションを提供します。
   • list_recent_emails または search_emails を使用する必要があります。
5. get_email_by_number：
   • 番号に基づいて特定のメールの詳細内容を取得します。
   • 完全な本文、受信者、添付ファイルを表示します。
   • キャッシュリストからメール番号を提供する必要があります。
   • メールに返信するオプションを提供します。
6. reply_to_email_by_number：
   • 番号に基づいて特定のメールに返信します。
   • キャッシュリストのメール番号を使用します。
   • 指定された本文内容で返信を送信します。
   • 元のメールスレッドを維持します。
   • オプション：「受信者」と「抄送」フィールドのカスタム受信者を指定できます。
     • デフォルトの動作はすべての受信者（差出人 + 抄送）に返信することです。
     • 必要に応じてデフォルトの受信者を上書きできます。
7. compose_email：
   • 新しいメールを作成して送信します。
   • 受信者、件名、本文内容をサポートします。
   • 追加の受信者を追加するための CC フィールドをオプションで使用できます。
   • Outlook クライアントを通じてメールを送信します。

サンプルワークフロー

1. list_folders を使用してすべての利用可能なメールフォルダを表示します。
2. list_recent_emails を使用して最近のメール（例えば、過去7日間のメール）を表示します。
3. search_emails を使用してキーワードでメールを検索します。
4. view_email_cache を使用してキャッシュされたメールを閲覧します。
5. get_email_by_number を使用して特定のメールの詳細情報を表示します。
6. reply_to_email_by_number を使用してメールに返信します。
7. compose_email を使用して新しいメールを作成して送信します。

🔧 技術詳細

注意事項

このサーバーはあなたの Outlook メールアカウントにアクセスでき、メールの読み取り、送信、管理が可能です。信頼できる MCP クライアントと安全な環境でのみ使用してください。

制限事項

• 現在はプレーンテキストのメールのみをサポートしています（HTML はサポートしていません）。
• 最大メール履歴は30日までです。
• 検索機能は Outlook の組み込み検索機能に依存しています。
• 基本的なメール機能のみをサポートしています（カレンダー、連絡先などはサポートしていません）。