Outlook MCP Server

Outlook MCP サーバー

LLM やその他の MCP クライアントが、標準化されたインターフェースを通じてメールの閲覧、検索、管理を行えるようにする、Microsoft Outlook のメール機能にアクセスするための Model Context Protocol（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 を使用して、メールに返信します

例

最近のメールを一覧表示する

Could you show me my unread emails from the last 3 days?

メールを検索する

Search for emails about "project update OR meeting notes" in the last week

メールの詳細を読む

Show me the details of email #2 from the list

メールに返信する

Reply to email #3 with: "Thanks for the information. I'll review this and get back to you tomorrow."

新しいメールを作成する

Send an email to [email protected] with subject "Meeting Agenda" and body "Here's the agenda for our upcoming meeting..."

トラブルシューティング

• 接続の問題：Outlook が起動しており、正しく設定されていることを確認してください
• 権限エラー：スクリプトに Outlook へのアクセス権限があることを確認してください
• 検索の問題：複雑な検索では、語句の間に OR 演算子を使用してみてください
• メールへのアクセスエラー：メール ID が有効で、アクセス可能であることを確認してください
• サーバーのクラッシュ：Outlook の接続と安定性を確認してください

セキュリティに関する考慮事項

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

制限事項

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