共用方式為


Microsoft Outlook 行事曆 MCP 伺服器參考

重要

你需要參加 Frontier 預覽計畫 ,才能搶 先取得 Microsoft Agent 365 的使用權。 Frontier 直接連結你與 Microsoft 最新的 AI 創新。 Frontier 預覽受限於您現有的客戶協議預覽條款。 由於這些功能仍在開發中,其可用性與功能可能會隨時間改變。

概觀

伺服器識別碼 Display name Description
mcp_CalendarTools Microsoft Outlook 行事曆 MCP Server 用於行事曆工具的 MCP 伺服器。 使用這個 MCP 伺服器來處理行事曆,例如建立、更新、檢索事件、管理邀請以及查詢可用性。

可用工具

mcp_CalendarTools_graph_acceptEvent

在使用者行事曆中接受指定的活動邀請。

必要參數

  • eventId:接受事件的ID。

選用參數。

  • userID: 使用者 ID 或 userPrincipalName
  • 評論: 回應中包含可選文字
  • sendResponse: 是否要向主辦者發送回應

mcp_CalendarTools_graph_cancelEvent

取消指定使用者行事曆中的活動並通知參加者。

必要參數

  • eventId: 取消事件的唯一識別碼

選用參數。

  • userID: 使用者 ID 或 userPrincipalName
  • 留言: 可選取消訊息

mcp_CalendarTools_graph_createEvent

在指定使用者的行事曆中建立一個新的行事曆事件。 支援定期活動及線上會議。

必要參數

  • 主旨: 事件主詞/標題(非空)
  • 開始: 以日期時間與時區開始時間戳記
  • 結束 :以dateTime和timeZone結束時間戳
  • attendees_addresses: 多元與會者電子郵件地址

選用參數。

  • userID: 使用者 ID 或 userPrincipalName
  • body: 事件本體,包含內容類型(Text/HTML)及內容
  • 地點: 顯示名稱地點
  • attendees_types: 參加者角色(必修、選修、資源)
  • attendees_names: 與會者顯示姓名
  • 重現: 重現模式與範圍
  • isOnlineMeeting: 線上會議設定為真
  • 線上會議供應商: teamsForBusiness、skypeForBusiness、skypeForConsumer
  • allowNewTimeProposals: 允許時間提案(預設:true)
  • transactionId: 冪등 識別碼

mcp_CalendarTools_graph_declineEvent

在使用者行事曆中拒絕指定的活動邀請。

必要參數

  • eventId: 拒絕事件的ID。

選用參數。

  • userID: 使用者 ID 或 userPrincipalName

  • 評論: 回應內容可選

  • sendResponse: 是否要發送回應

mcp_CalendarTools_graph_deleteEvent

從指定使用者的行事曆刪除事件。

必要參數

  • eventId: 要刪除事件的唯一識別碼

選用參數。

  • userID: 使用者 ID 或 userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

根據主辦單位和參加者的可用性,建議會議時間和地點。

必要參數

  • 會議時間: 會議時長(例如「PT1H」)

選用參數。

  • userID: 組織者 ID 或 userPrincipalName
  • attendees_addresses: 參加者電子郵件地址
  • attendees_types: 參加者類型
  • attendees_names: 與會者顯示姓名
  • timeConstraint: 時間可用性與 activityDomain
  • locationConstraint: 地點選項
  • maxCandidates: 最大建議
  • isOrganizerOptional: 組織者可選旗標
  • returnSuggestionReasons: 包含理由
  • 最低出席率: 最低出席門檻

mcp_CalendarTools_graph_getEvent

從指定使用者的行事曆中取得單一行事曆事件。

必要參數

  • eventId: 事件的唯一識別碼

選用參數。

  • userID: 使用者 ID 或 userPrincipalName
  • select: OData $select query parameter
  • 展開: OData $expand 用於導航屬性

mcp_CalendarTools_graph_getSchedule

取得使用者、發行清單或資源的空閒/忙碌排程。

必要參數

  • 排程: 使用者或資源的 SMTP 位址
  • startTime: 起始時間與日期時間及時區
  • endTime: 結束時間,日期時間與 timeZone 表示

選用參數。

  • userID: 使用者 ID 或 userPrincipalName
  • 可用性ViewInterval: 時隙長度(分鐘)

mcp_CalendarTools_graph_listCalendarView

為使用者在指定時間範圍內取得行事曆事件。

必要參數

  • 起始日期時間: 時間範圍開始(ISO 8601)
  • endDateTime: 時間範圍結束(ISO 8601)

選用參數。

  • userID: 使用者 ID 或 userPrincipalName
  • 頂部: 最大項目數量
  • orderby: 按子句排序

mcp_CalendarTools_graph_listEvents

從指定使用者的行事曆中取得事件清單。

選用參數。

  • userID: 使用者 ID 或 userPrincipalName
  • 起始日期時間: 時間範圍開始(ISO 8601)
  • endDateTime: 時間範圍結束(ISO 8601)
  • 事件數目上限。
  • filter: OData filter query
  • orderby: OData 依查詢排序

mcp_CalendarTools_graph_updateEvent

更新指定使用者行事曆中的現有事件。

必要參數

  • eventId: 事件的唯一識別碼

選用參數。

  • userID: 使用者 ID 或 userPrincipalName
  • 主旨: 更新主旨
  • 正文: 更新的身體內容
  • 開始時間: 更新後的開始時間
  • 結束: 更新結束時間
  • 地點: 更新地點
  • attendees_addresses: 更新的與會者電子郵件
  • attendees_types: 最新參加者類型
  • attendees_names: 最新與會者姓名
  • isCancelled: 設為 true 以取消
  • 復發: 更新的復發模式

主要功能

事件管理

  • 建立、讀取、更新及刪除
  • 接受、拒絕及取消邀請
  • 支援重複舉辦的活動
  • 與線上會議(Teams、Skype)整合

可用性和排程命令

  • 安排空閒或繁忙的行程
  • 透過查詢可用性查詢會議時間
  • 帶有時間範圍篩選功能的行事曆檢視
  • 參加者可用性分析

與會者管理

  • 管理必修、選修及資源參加者
  • 支持時間提案
  • 追蹤回應
  • 支援分配名單

週期模式

  • 每日、每週、每月,以及每年。
  • 絕對與相對重現
  • 結束日期或發生次數
  • 星期幾與月份規格

線上會議

  • 與 Teams for Business 的整合
  • 商務用 Skype 的支援。
  • Skype for Consumer 的支援
  • 自動會議連結產生

注意事項

  1. 所有時間戳皆使用 UTC/ISO 8601 格式,並附帶時區
  2. 行事曆 MCP 依賴 UserprofileMCP 來尋找組織中的使用者
  3. 電子郵件必須是有效的格式。
  4. 出席者陣列(地址、類型、名稱)必須保持相同順序
  5. 線上會議需要 isOnlineMeeting=true 和 onlineMeetingProvider
  6. 重現需要模式與範圍物件
  7. 時區應該在開始和結束時間上保持一致
  8. TransactionID 使事件建立冪等(idemsection) 事件得以實現