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文件以獲取詳細信息。

版權所有 (c) [年份] [您的姓名]
保留所有權利

許可在滿足以下條件的情況下授予：

1. 您必須保留版權聲明和此許可聲明。
2. 您不得將本軟件用於商業用途，除非獲得明確授權。

無明示或暗示的其他保證。作者或版權持有人不對任何索賠、損害或其他責任負責。