Outlook Calendar MCP

🚀 Outlook日曆MCP工具

這是一個Model Context Protocol（MCP）服務器，允許Claude訪問和管理本地Microsoft Outlook日曆，僅限Windows系統使用，為用戶提供便捷的日曆操作體驗。

🚀 快速開始

Outlook日曆MCP工具是一個允許Claude訪問和管理本地Microsoft Outlook日曆的MCP服務器。在使用前，請確保滿足以下先決條件：

• 操作系統：Windows 7 或更高版本
• Outlook：Microsoft Outlook 2013 或更高版本，或 Microsoft Outlook 365
• Node.js：v8.0.0 或更高版本
• npm：v5.0.0 或更高版本

✨ 主要特性

• 查看日曆事件：可查看所有日曆事件。
• 創建日曆事件：能夠添加新的日曆事件。
• 更新日曆事件：支持修改現有日曆事件。
• 刪除日曆事件：可刪除不需要的日曆事件。
• 獲取 attendee 狀態：可以檢查attendee的響應狀態。
• 查找空閒時間：能查找可用時間段。
• 獲取日曆列表：可顯示所有可用日曆。

📦 安裝指南

方法一：使用npm安裝

npm install outlook-calendar-mcp-tool --save-dev

方法二：從源代碼安裝

1. 克隆倉庫：

   git clone https://github.com/your-username/outlook-calendar-mcp-tool.git
   cd outlook-calendar-mcp-tool
   

2. 安裝依賴：

   npm install
   

📚 詳細文檔

配置說明

MCP服務器配置

針對Claude Desktop App：

{
  "operations": {
    "outlookCalendar": {
      "enabled": true,
      "configurations": {
        "pathToOutlook": "C:\\Program Files\\Microsoft Office\\Office16\\OUTLOOK.EXE",
        "defaultCalendar": "Personal Calendar"
      }
    }
  }
}

針對Claude VSCode擴展：

{
  "outlookCalendarMcpTool": {
    "outlookPath": "C:\\Program Files\\Microsoft Office\\Office16\\OUTLOOK.EXE",
    "defaultCalendarName": "Personal Calendar"
  }
}

使用指南

命令說明

查看日曆事件

list_events [--calendar <日曆名稱>] [--start <開始日期>] [--end <結束日期>]

創建日曆事件

create_event --title <標題> --start <開始時間> --end <結束時間> [--location <地點>] [--description <描述>] [--calendar <日曆名稱>]

更新日曆事件

update_event --id <事件ID> [--title <新標題>] [--start <新開始時間>] [--end <新結束時間>] [--location <新地點>] [--description <新描述>] [--calendar <目標日曆>]

刪除日曆事件

delete_event --id <事件ID>

獲取 attendee 狀態

get_attendee_status --event-id <事件ID>

查找空閒時間

find_available_time [--duration <持續時間>] [--start <開始時間>] [--end <結束時間>]

獲取日曆列表

get_calendars

🔧 技術細節

安全注意事項

• 首次使用時，Outlook可能會顯示安全提示，請允許腳本訪問您的Outlook數據。
• 該工具僅訪問本地Outlook客戶端，不會將日曆數據發送到外部服務器。
• 所有日曆操作均在您計算機上本地進行。

故障排除

• Outlook安全提示：遇到安全提示時，請按照提示允許腳本訪問您的Outlook數據。
• 腳本執行策略問題：如果出現腳本執行錯誤，請檢查並調整您的PowerShell執行策略。
• 路徑問題：確保配置文件中的路徑指向正確的工具位置。

🤝 項目貢獻

歡迎為Outlook日曆MCP工具貢獻力量！請參考我們的貢獻指南瞭解如何開始。

📄 許可證

本項目遵從MIT許可證，具體條款詳見LICENSE文件。