Note
本文說明由標準執行架構驅動的 Agent 或 Agent 流程中所使用的功能。
Important
這是預覽功能。
- Microsoft 會在正式發行前釋出預覽功能，讓客戶能搶先體驗並提供回饋。
- 預覽功能功能有限，且不適合生產環境使用。
- Microsoft 可能會更改預覽版 MCP 工具名稱和參數。 避免硬編碼的相依關係。 Microsoft 維持情境支援。
- 預覽功能須遵守Microsoft補充使用條款。
Note
針對特定應用程式的 Microsoft 365 MCP 工具（Copilot、行事曆、郵件、SharePoint、OneDrive、Teams、User 和 Word）僅用於向下相容，不應用於生產環境或新專案。 對於需要存取 Microsoft 365 資源的新專案，請使用 Work IQ MCP 搭配 GitHub Copilot 工具。 欲了解更多資訊，請參閱 Copilot Studio 中的 Work IQ MCP。
Overview
| 伺服器識別碼 | 租戶層級 URL | 顯示名稱 | Description |
|---|---|---|---|
mcp_CalendarTools |
https://agent365.svc.cloud.microsoft/agents/tenants/{tenantId}/servers/mcp_CalendarTools |
日曆 | 用於行事曆運作的工具，如建立、更新、檢索活動、管理邀請及查詢可用性。 |
可用工具
mcp_CalendarTools_graph_acceptEvent
在使用者行事曆中接受指定的活動邀請。
必要參數：
- eventId：接受事件的ID。
選擇性參數：
-
使用者ID：使用者ID或
userPrincipalName - 評論：回應中包含可選文字
- sendResponse：是否要向主辦者發送回應
mcp_CalendarTools_graph_cancelEvent
取消指定使用者行事曆中的活動並通知參加者。
必要參數：
- eventId：取消事件的唯一識別碼
選擇性參數：
-
使用者ID：使用者ID或
userPrincipalName - 留言：可選取消訊息
mcp_CalendarTools_graph_createEvent
在指定使用者的行事曆中建立一個新的行事曆事件。 支援定期活動及線上會議。
必要參數：
- 主旨：事件主詞或標題（非空）
-
start：使用
dateTime和timeZone的開始時間戳記 -
end：包含
dateTime和timeZone的結束時間戳記 - attendees_addresses：參加者電子郵件地址列表
選擇性參數：
-
使用者ID：使用者ID或
userPrincipalName - body：事件本體，包含內容類型（Text/HTML）及內容
-
位置：具有
displayName的位置 - attendees_types：參加者角色（必修、選修、資源）
- attendees_names：與會者顯示姓名
- 重現：重現模式與範圍
- isOnlineMeeting：若為線上會議，請設為 true
-
onlineMeetingProvider：
teamsForBusiness，skypeForBusiness，skypeForConsumer - allowNewTimeProposals：允許時間提案（預設：true）
-
transactionId：
Idempotence識別碼
mcp_CalendarTools_graph_declineEvent
在使用者行事曆中拒絕指定的活動邀請。
必要參數：
- eventId：要拒絕的事件識別碼
選擇性參數：
使用者ID：使用者ID或
userPrincipalName評論：回應內容可選
sendResponse：是否要發送回應
mcp_CalendarTools_graph_deleteEvent
從指定使用者的行事曆刪除事件。
必要參數：
- eventId：要刪除事件的唯一識別碼
選擇性參數：
-
使用者ID：使用者ID或
userPrincipalName
mcp_CalendarTools_graph_findMeetingTimes
根據主辦單位和參加者的可用性，建議會議時間和地點。
必要參數：
- 會議時間：會議時長（例如「PT1H」）
選擇性參數：
-
使用者ID：組織者ID或
userPrincipalName - attendees_addresses：與會者電子郵件地址
- attendees_types：參加者類型
- attendees_names：與會者顯示姓名
-
timeConstraint：時間可用性（含
timeslots和activityDomain） - locationConstraint：地點選項
- maxCandidates：最大建議數
- isOrganizerOptional：組織者可選旗標
- returnSuggestionReasons：包含理由
- 最低出席率：最低出席門檻
mcp_CalendarTools_graph_getEvent
從指定使用者的行事曆中取得單一行事曆事件。
必要參數：
- eventId：事件的唯一識別碼
選擇性參數：
-
使用者ID：使用者ID或
userPrincipalName -
select： OData
\$select查詢參數 -
展開：OData
\$expand用於導航屬性
mcp_CalendarTools_graph_getSchedule
取得使用者、發行清單或資源的空閒/忙碌排程。
必要參數：
- 排程：使用者或資源的 SMTP 位址
-
startTime：含有
dateTime和timeZone的開始時間 -
endTime：含有
dateTime和timeZone的結束時間
選擇性參數：
-
使用者ID：使用者ID或
userPrincipalName - 可用性ViewInterval：時隙長度（分鐘）
mcp_CalendarTools_graph_listCalendarView
為使用者在指定時間範圍內取得行事曆事件。
必要參數：
- 起始日期時間：時間範圍開始（ISO 8601）
- endDateTime：時間範圍結束（ISO 8601）
選擇性參數：
-
使用者ID：使用者ID或
userPrincipalName - 頂部：最大項目數量
- orderby：排序依據子句
mcp_CalendarTools_graph_listEvents
從指定使用者的行事曆中取得事件清單。
選擇性參數：
-
使用者ID：使用者ID或
userPrincipalName - 起始日期時間：時間範圍開始（ISO 8601）
- endDateTime：時間範圍結束（ISO 8601）
- 頂部：最多項目數量
- filter：OData 篩選查詢
- orderby：OData order by 查詢
mcp_CalendarTools_graph_updateEvent
更新指定使用者行事曆中的現有事件。
必要參數：
- eventId：事件的唯一識別碼
選擇性參數：
-
使用者ID：使用者ID或
userPrincipalName - 主旨：更新主旨
- 本文：已更新本文內容
- 開始時間：更新後的開始時間
- 結束：更新結束時間
- 地點：更新地點
- attendees_addresses：最新與會者電子郵件
- attendees_types：更新的參加者類型
- attendees_names：最新與會者姓名
- isCancelled：設為 true 以取消
- 重複：更新的重複模式
關鍵功能
事件管理
- 建立、閱讀、更新及刪除事件。
- 接受、拒絕並取消邀請。
- 支援週期性活動。
- 與線上會議（Teams、Skype）整合。
可用性與排程
- 取得忙碌/空閒時程表。
- 透過可用性查詢來尋找會面時間。
- 帶有時間範圍篩選功能的行事曆檢視。
- 參加者可用性分析。
與會者管理
- 管理必要、選用及資源出席者。
- 支援時間提案。
- 追蹤回應。
- 支援通訊群組清單。
重現模式
- 每日、每週、每月和每年的模式。
- 絕對與相對的重複出現。
- 結束日期或發生次數。
- 星期幾與月份規格。
線上會議
- 與 Teams for Business 的整合
- 商務用 Skype 支援
- 支援 Skype（個人使用）
- 自動會議連結產生
Notes
- 所有時間戳皆使用 UTC/ISO 8601 格式，並附帶時區
- 行事曆 MCP 依賴
UserprofileMCP來尋找組織中的使用者 - 電子郵件地址格式必須有效
- 出席者陣列（地址、類型、名稱）必須保持相同順序
- 線上會議需要
isOnlineMeeting=true和onlineMeetingProvider - 重復性需要模式和範圍物件
- 時區應該在開始和結束時間上保持一致
-
TransactionId啟用idempotent事件創建