Outlookmcpserver

🚀 OutlookMCPServer

このプロジェクトはMCPサーバーで、Microsoft Graph APIを通じてClaude DesktopにMicrosoft 365のメール、カレンダー、および（近日公開予定の）ファイルへのアクセスを提供します。

🚀 クイックスタート

# 環境の設定
uv venv
uv pip install -r uv.lock

# MCP Inspectorを使用してローカルで実行
mcp dev main.py（エラーが発生する可能性があります）

Claudeを使用してデバッグする前に、Inspectorで問題を解決することをおすすめします。

✨ 主な機能

• ✅ メールアクセス：Claudeまたはその他のMCP互換エージェントから、受信トレイの作成、返信、並べ替え、検索、フィルタリング、分析を行うことができます。
• 🔜 カレンダーサポート：日付で一覧表示、作成、削除（近日公開予定：更新、検索）
• 🚧 OneDriveサポート：メールとカレンダー機能が安定した後の将来的な開発方向

🧱 技術スタック

• msgraph（最新のMicrosoft Graph SDK）
• azure.identity は DeviceCodeCredential と TokenCachePersistenceOptions を使用
• FastMCP — シンプルなMCP互換サーバーインターフェイス
• uv — 高速なPythonの依存関係と環境管理ツール

⚙️ 実行要件

このプロジェクトの現在のバージョンは、以下の環境で動作します。

• macOS でのローカル実行
• Claude Desktop との併用
• Azureポータルで登録されたアプリケーションを使用した認証

⚠️ 重要提示

このプロジェクトを構成するには、Azureテナントの管理者アクセス権が必要です。アプリケーション登録には、Microsoft Graphのスコープ（例：Mail.Read、Calendars.Read）に対する同意が必要で、デフォルトではほとんどの組織のユーザーは自分で同意することができません。

🔐 認証設定

アプリケーションを実行する前に、以下の手順を完了する必要があります。

1. プロジェクトのルートディレクトリに auth_cache フォルダを作成します。

mkdir -p auth_cache

2. プロジェクトのルートディレクトリに .env ファイルを作成します。

touch .env

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

echo "AZURE_CLIENT_ID=<Azureポータルで取得したあなたのID>" > .env
echo "AZURE_TENANT_ID=<Azureポータルで取得したあなたのID>" >> .env
echo "AZURE_GRAPH_SCOPES=User.Read;Mail.Read;Calendars.Read" >> .env

💻 使用例

基本的な使用法

Claude Desktopでこのプロジェクトを使用するには、Claude/settings.json ファイルに以下の内容を追加します。

{
  "outlook-mcp-server": {
    "enabled": true,
    "config": {
      "serverUri": "http://localhost:8080"
    }
  }
}

注意：必要に応じて、serverUri のパスを置き換える必要があります。

📁 プロジェクト構造

あなたのプロジェクトディレクトリには、以下のファイルとフォルダが含まれている必要があります。
- main.py           # メインプログラムファイル
- requirements.txt   # 依存関係管理ファイル
- .env               # 環境変数設定ファイル
- auth_cache/        # 認証キャッシュフォルダ

🌟 ロードマップ

• 現在の機能：
  • メールの送受信
  • カレンダーイベントの表示
• 近日公開予定の機能：
  • メールの更新
  • カレンダーイベントの作成と管理
• 将来の計画：
  • OneDriveファイルへのアクセス

📄 ライセンス

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

Copyright (c) [Year] [Your Name]
All rights reserved.

Permission is hereby granted, subject to the following conditions:

1. You must retain the copyright notice and this permission notice.
2. You may not use this software for commercial purposes without explicit authorization.

There is no other warranty, whether express or implied. The author or copyright holder is not liable for any claims, damages, or other liabilities.