Outlook MCP Server

🚀 Outlook MCP サーバー

このサーバーは、Microsoft Outlook のメール機能にアクセスするためのモデルコンテキストプロトコル（MCP）サーバーです。大規模言語モデル（LLMs）やその他の MCP クライアントが、標準化されたインターフェースを通じてメールの読み取り、検索、管理を行うことを可能にします。

✨ 主な機能

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

📦 インストール

前提条件

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

インストール手順

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

pip install mcp>=1.2.0 pywin32>=305

3. Claude Desktop（または他の好みの MCP クライアント）をこのサーバーを使用するように設定します。

📚 ドキュメント

設定

Claude Desktop の設定

MCP_client_config.json ファイルに以下の内容を追加します。

{
  "mcpServers": {
    "outlook": {
      "command": "python",
      "args": ["Your path\\outlook_mcp_server.py"],
      "env": {}
    }
  }
}

使用方法

サーバーの起動

サーバーを直接起動することができます。

python outlook_mcp_server.py

または、Claude Desktop などの MCP クライアントが設定を通じてサーバーを起動することもできます。

利用可能なツール

このサーバーは以下のツールを提供します。

1. list_folders：Outlook 内のすべての利用可能なメールフォルダを一覧表示します。
2. list_recent_emails：指定した日数内の最近のメールの件名を表示します。
3. search_emails：連絡先の名前またはキーワードでメールを検索します。
4. get_email_by_number：特定のメールの詳細内容を取得します。
5. reply_to_email_by_number：特定のメールに返信します。
6. compose_email：新しいメールを作成して送信します。

サンプルワークフロー

1. list_folders を使用して、すべての利用可能なメールフォルダを確認します。
2. list_recent_emails を使用して、最近のメール（例えば、過去 7 日間）を確認します。
3. search_emails を使用して、特定のキーワードでメールを検索します。
4. get_email_by_number を使用して、完全なメール内容を表示します。
5. reply_to_email_by_number を使用して、メールに返信します。

サンプル

最近のメールを一覧表示

過去 3 日間の未読メールを表示してくれますか？

メールを検索

過去 1 週間の「プロジェクト更新 または 会議メモ」に関するメールを検索します。

メールの詳細を表示

リストの 2 番目のメールの詳細情報を表示します。

メールに返信

3 番目のメールに「あなたの情報ありがとうございます。検討して明日返信します。」と返信します。

新しいメールを作成

件名が「会議議題」、宛先が john.doe@example.com、本文が「これは次回の会議の議題です...」のメールを送信します。

トラブルシューティング

• 接続問題：Outlook が実行中で、正しく設定されていることを確認してください。
• 権限エラー：スクリプトが Outlook にアクセスする権限を持っていることを確認してください。
• 検索問題：複雑な検索の場合は、キーワード間に OR 演算子を使用してみてください。
• メールアクセスエラー：メールボックス ID が有効で、アクセス可能であることを確認してください。
• サーバークラッシュ：Outlook の接続と安定性を確認してください。

セキュリティに関する注意事項

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

制限事項

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