日历参考(预览)

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 事件创建