MCP Outlook Tools

🚀 MCP Outlook 工具

MCP Outlook 工具是一個基於模型上下文協議（MCP）的服務器實現，它讓 AI 助手能夠與 Microsoft Outlook 進行交互，實現日曆管理、郵件操作和搜索功能。

✨ 主要特性

• 📅 日曆管理

  • 獲取指定日期範圍內的日曆項。
  • 添加包含完整詳細信息的新預約。
  • 支持分類和忙碌狀態設置。

• 📧 郵件操作

  • 向收件人及抄送對象發送郵件。
  • 發送前顯示確認信息。
  • 支持完整的郵件正文格式設置。

• 🔍 郵件搜索

  • 按日期和關鍵詞搜索郵件。
  • 從地址中提取用戶信息。
  • 支持日文文本編碼。

📦 安裝指南

環境要求

• Windows 操作系統（pywin32 依賴）。
• 已安裝並配置好 Microsoft Outlook。
• Python 3.10 或更高版本。
• 兼容 MCP 的 AI 助手（如 Claude Desktop）。

安裝步驟

1. 克隆倉庫：

git clone https://github.com/wmoto-ai/mcp-outlook-tools.git
cd mcp-outlook-tools

2. 使用 uv 安裝依賴：

uv pip install -e .

或者使用 pip 安裝：

pip install -e .

📚 詳細文檔

配置

針對 Claude Desktop

將以下內容添加到你的 Claude Desktop 配置文件中：

Windows：%APPDATA%\Claude\claude_desktop_config.json macOS：~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "outlook-tools": {
      "command": "uv",
      "args": [
        "--directory",
        "C:/path/to/mcp-outlook-tools",
        "run",
        "--with-editable",
        ".",
        "-m",
        "outlook_tools.server"
      ],
      "cwd": "C:/path/to/mcp-outlook-tools",
      "env": {
        "PYTHONIOENCODING": "utf-8"
      }
    }
  }
}

使用方法

配置完成後，你的 AI 助手將可以使用以下工具：

add_appointment

向 Outlook 日曆添加新預約
參數:
- subject: 預約標題
- start_time: 開始日期和時間（YYYY-MM-DD HH:MM）
- end_time: 結束日期和時間（YYYY-MM-DD HH:MM）
- location: 會議地點（可選）
- description: 詳細描述（可選）
- categories: 以逗號分隔的分類（可選）
- busy_status: 0=空閒, 1=暫定, 2=忙碌, 3=不在辦公室（默認: 1）

get_calendar

獲取指定日期範圍內的日曆項
參數:
- start_date: 開始日期（YYYY-MM-DD）
- end_date: 結束日期（YYYY-MM-DD）

send_email

通過 Outlook 發送郵件
參數:
- to: 收件人郵箱地址（以分號分隔）
- cc: 抄送收件人（以分號分隔）
- subject: 郵件主題
- body: 郵件正文文本

項目結構

mcp-outlook-tools/
├── src/
│   └── outlook_tools/
│       ├── __init__.py
│       ├── server.py           # MCP 服務器實現
│       ├── calendar_service.py # 日曆操作
│       └── search_service.py   # 郵件搜索操作
├── test/                       # 測試文件
├── pyproject.toml             # 項目配置
└── README.md                  # 本文件

開發

運行測試

pytest test/

類型檢查

pyright src/

代碼檢查

ruff check src/

安全注意事項

• 此工具需要訪問你本地安裝的 Outlook。
• 郵件在發送前會顯示給用戶確認。
• 代碼中不存儲任何憑證。
• 所有操作都使用 Windows COM 接口，並依賴現有的 Outlook 身份驗證。

侷限性

• 僅支持 Windows 系統（由於依賴 pywin32）。
• 需要安裝並配置好 Outlook。
• 時區處理假設為日本標準時間（JST，+9 小時）。

貢獻

歡迎貢獻代碼！請隨時提交拉取請求。

許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。

致謝

• 基於 FastMCP 框架構建。
• 使用 pywin32 實現 Outlook COM 接口。