重要
你需要參加 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 的支援
- 自動會議連結產生
注意事項
- 所有時間戳皆使用 UTC/ISO 8601 格式,並附帶時區
- 行事曆 MCP 依賴 UserprofileMCP 來尋找組織中的使用者
- 電子郵件必須是有效的格式。
- 出席者陣列(地址、類型、名稱)必須保持相同順序
- 線上會議需要 isOnlineMeeting=true 和 onlineMeetingProvider
- 重現需要模式與範圍物件
- 時區應該在開始和結束時間上保持一致
- TransactionID 使事件建立冪等(idemsection) 事件得以實現