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或
userPrincipalNamecomment:回應內容可選
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事件