日曆參考(預覽)

Note

本文描述由 標準線束驅動的代理或代理流程中使用的功能。

Important

這是預覽功能。

  • Microsoft 會在正式發行前釋出預覽功能,讓客戶能搶先體驗並提供回饋。
  • 預覽功能功能有限,且不適合生產環境使用。
  • Microsoft 可能會更改預覽版 MCP 工具名稱和參數。 避免硬編碼的相依關係。 Microsoft 維持情境支援。
  • 預覽功能須遵守Microsoft補充使用條款。

Note

針對特定應用程式的 Microsoft 365 MCP 工具(Copilot、行事曆、郵件、SharePoint、OneDrive、Teams、User 和 Word)僅用於向下相容,不應用於生產環境或新專案。 對於需要存取 Microsoft 365 資源的新專案,請使用 Work IQ MCP 搭配 Microsoft Copilot 工具。 欲了解更多資訊,請參閱 Copilot Studio 中的 Work IQ MCP。

概觀

伺服器識別碼 租戶層級 URL 顯示名稱 Description
mcp_CalendarTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_CalendarTools
行事曆 用於行事曆運作的工具,如建立、更新、檢索活動、管理邀請及查詢可用性。

可用工具

mcp_CalendarTools_graph_acceptEvent

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

必要參數:

  • eventId:要接受的事件識別碼

選擇性參數:

  • 使用者ID:使用者ID或 userPrincipalName
  • comment:回應中包含的選用文字
  • sendResponse:是否要向主辦者傳送回應

mcp_CalendarTools_graph_cancelEvent

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

必要參數:

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

選擇性參數:

  • 使用者ID:使用者ID或 userPrincipalName
  • 註解:選填的取消訊息

mcp_CalendarTools_graph_createEvent

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

必要參數:

  • 主題:事件主題或標題(非空)
  • 開始:含有 dateTime 和 timeZone 的開始時間戳記
  • 結束:結束時間戳,包含 dateTime 和 timeZone
  • attendees_addresses:參加者電子郵件地址列表

選擇性參數:

  • userId:User ID 或 userPrincipalName
  • body:事件本體,包含內容類型(Text/HTML)及內容
  • location:位置資訊 displayName
  • attendees_types:參加者角色(必選、可選、資源)
  • attendees_names:與會者顯示姓名
  • 週期:週期模式與範圍
  • isOnlineMeeting:若為線上會議,則設為 true
  • onlineMeetingProvider: teamsForBusiness, skypeForBusiness, skypeForConsumer
  • allowNewTimeProposals:允許時間提案(預設:true)
  • transactionId: Idempotence 識別碼

日曆工具_圖表_拒絕事件(mcp_CalendarTools_graph_declineEvent)

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

必要參數:

  • eventId:拒絕事件的ID。

選擇性參數:

  • 使用者ID:使用者ID或 userPrincipalName

  • comment:回應內容可選

  • sendResponse:是否要發送回應

mcp_CalendarTools_graph_deleteEvent

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

必要參數:

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

選擇性參數:

  • userId:使用者ID或 userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

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

必要參數:

  • meetingDuration:會議持續時間(例如「PT1H」)

選擇性參數:

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

mcp_CalendarTools_graph_getEvent

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

必要參數:

  • eventId:事件的唯一識別碼

選擇性參數:

  • userId:使用者ID或 userPrincipalName
  • select: OData \$select 查詢參數
  • 展開:用於導覽屬性的 OData \$expand

mcp_CalendarTools_graph_getSchedule

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

必要參數:

  • 排程: 使用者或資源的 SMTP 位址
  • startTime:開始時間,包含 dateTime 和 timeZone
  • 結束時間:結束時間,包含 dateTime 和 timeZone

選擇性參數:

  • 使用者ID:使用者ID或 userPrincipalName
  • availabilityViewInterval:時隙長度(分鐘)

mcp_行事曆工具_graph_清單行事曆視圖

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

必要參數:

  • startDateTime:時間範圍的開始(ISO 8601)
  • endDateTime:時間範圍結束(ISO 8601)

選擇性參數:

  • 使用者ID:使用者ID或 userPrincipalName
  • top:最大事件數量
  • orderby:排序子句

mcp_CalendarTools_graph_listEvents

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

選擇性參數:

  • 使用者ID:使用者ID或 userPrincipalName
  • 起始日期時間:時間範圍開始(ISO 8601)
  • endDateTime:時間範圍結束(ISO 8601)
  • 頂部:最多項目數量
  • filter:OData 篩選查詢
  • orderby:OData 排序查詢

mcp_CalendarTools_graph_updateEvent

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

必要參數:

  • eventId:事件的唯一識別碼

選擇性參數:

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

關鍵功能

事件管理

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

可用性與排程

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

與會者管理

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

重現模式

  • 每日、每週、每月和每年的模式。
  • 絕對與相對的重複出現。
  • 結束日期或發生次數。
  • 星期幾和月份的規格。

線上會議

  • 與 Teams for Business 的整合
  • 商務用 Skype 支援
  • 支援 Skype(個人使用)
  • 自動會議連結產生

附註

  • 所有時間戳皆使用 UTC/ISO 8601 格式,並附帶時區
  • 行事曆 MCP 依賴 UserprofileMCP 來尋找組織中的使用者
  • 電子郵件地址格式必須有效
  • 出席者陣列(地址、類型、名稱)必須保持相同順序
  • 線上會議需要 isOnlineMeeting=true 和 onlineMeetingProvider
  • 重復性需要模式和範圍物件
  • 時區應該在開始和結束時間上保持一致
  • TransactionId 啟用建立 idempotent 事件