Note
本文介绍了由 标准线束驱动的代理或代理流中使用的功能。
Important
这是一项预览功能。
- Microsoft正式发布之前发布预览版功能,以便客户能够提前访问并提供反馈。
- 预览功能具有受限的功能,不适用于生产用途。
- Microsoft可能会更改预览 MCP 工具名称和参数。 避免硬编码依赖项。 Microsoft 提供场景支持。
- 预览功能受Microsoft补充使用条款的约束。
Note
针对特定应用的 Microsoft 365 MCP 工具(Copilot、日历、邮件、SharePoint、OneDrive、Teams、User 和 Word)仅用于向后兼容,不应用于生产环境或新项目。 对于需要访问 Microsoft 365 资源的新项目,请结合 Microsoft Copilot 工具框架使用 Work IQ MCP。 更多信息请参见 Copilot Studio 中的 Work IQ MCP。
Overview
| 服务器 ID | 租户级 URL | 显示名称 | 说明 |
|---|---|---|---|
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 - comment:可选取消信息
mcp_CalendarTools_graph_createEvent
在指定的用户的日历中创建新的日历事件。 支持定期事件和联机会议。
所需参数:
- 主题:事件主题或标题(非空)
-
开始:带有
dateTime和timeZone的开始时间戳 -
结束:结束时间戳,带有
dateTime和timeZone - attendees_addresses:与会者电子邮件地址数组
可选参数:
-
用户ID:用户ID或
userPrincipalName - 正文:事件体,包含内容类型(文本/HTML)和内容
-
地点:地点
displayName - attendees_types:与会者角色(必须出席、可选、资源)
- attendees_names:与会者展示姓名
- recurrence:重复模式和范围
- isOnlineMeeting:设置为 true 表示在线会议
-
onlineMeetingProvider:
teamsForBusiness,skypeForBusiness,skypeForConsumer - allowNewTimeProposals:允许时间提案(默认:true)
-
transactionId:
Idempotence标识符
mcp_CalendarTools_graph_declineEvent
在用户的日历中拒绝指定的事件邀请。
所需参数:
- eventId:拒绝事件的ID。
可选参数:
用户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:包含原因
- minimumAttendeePercentage:最低出席门槛
mcp_CalendarTools_graph_getEvent
从指定的用户的日历中获取单个日历事件。
所需参数:
- eventId:事件的唯一标识符
可选参数:
-
用户ID:用户ID或
userPrincipalName -
select: OData
\$select查询参数 -
expand:用于导航属性的 OData
\$expand查询参数
mcp_CalendarTools_graph_getSchedule
获取用户、通讯组列表或资源的忙/闲计划。
所需参数:
- 日程安排:用户或资源的 SMTP 地址
-
startTime:带有
dateTime和timeZone的开始时间 -
endTime:结束时间,包含
dateTime和timeZone
可选参数:
-
用户ID:用户ID或
userPrincipalName - availabilityViewInterval:时隙长度(分钟)
mcp_CalendarTools_graph_listCalendarView
检索用户在指定时间范围内的日历事件。
所需参数:
- startDateTime:时间范围的开始时间(ISO 8601)
- endDateTime:时间范围结束(ISO 8601)
可选参数:
-
用户ID:用户ID或
userPrincipalName - top:最大事件数
- orderby:排序子句
mcp_CalendarTools_graph_listEvents
从指定用户的日历中检索事件列表。
可选参数:
-
用户 ID:用户 ID 或
userPrincipalName - startDateTime:时间范围开始(ISO 8601)
- endDateTime:时间范围结束(ISO 8601)
- top:最大事件数
- filter: OData filter 查询
- orderby:OData 排序查询
mcp_CalendarTools_graph_updateEvent
更新指定用户的日历中的现有日历事件。
所需参数:
- eventId:事件的唯一标识符
可选参数:
-
用户ID:用户ID或
userPrincipalName - 主题:更新主题
- 正文:更新后的正文内容
- 开始:更新的开始时间
- 结束:更新结束时间
- location:已更新
- attendees_addresses:已更新与会者电子邮件地址
- attendees_types:最新参与者类型
- attendees_names:已更新的与会者姓名
- isCancelled:将其设为 true 以取消
- 重复:已更新的重复模式
主要功能
事件管理
- 创建、读取、更新和删除事件。
- 接受、拒绝和取消邀请。
- 支持定期事件。
- 与在线会议(Teams、Skype)集成。
可用性和计划
- 安排空闲或繁忙的日程。
- 通过可用性查询找到会议时间。
- 带有时间范围过滤功能的日历视图。
- 与会人数可用性分析。
与会者管理
- 管理必需、可选和资源与会者。
- 支持时间提案。
- 跟踪回复。
- 支持分发列表。
重复模式
- 每日、每周、每月和每年的模式。
- 绝对且相对的复发。
- 结束日期或事件计数。
- 星期几和月份的规格。
线上会议
- 与 Teams for Business 集成
- 支持Skype for Business
- 支持Skype(供个人使用)
- 自动会议链接生成
备注
- 所有时间戳使用附带时区信息的 UTC/ISO 8601 格式。
- 日历MCP依赖于
UserprofileMCP在组织内查找用户 - 电子邮件必须采用有效格式。
- 与会者数组(地址、类型、姓名)必须按相同顺序
- 在线会议需要
isOnlineMeeting=true和onlineMeetingProvider - 重复性要求同时具有模式对象和范围对象
- 时区应在开始和结束时间之间保持一致
-
TransactionId支持idempotent事件创建