工作 IQ 日历参考（预览版）

重要

  • 这是一项预览功能。
  • 预览功能不适用于生产环境，并且可能具有受限的功能。 这些功能受补充使用条款的约束，并在正式发布之前可用，以便客户提前访问并提供反馈。

Overview

服务器 ID 显示名称 Description
mcp_CalendarTools 工作IQ日历 日历工具的 MCP 服务器。 将此 MCP 服务器用于日历作，例如创建、更新、检索事件、管理邀请和检查可用性。

注意

  • 使用以前版本的 Microsoft MCP 服务器（如 Microsoft Teams MCP 服务器）的现有连接仍受支持。
  • 对于所有新连接，请使用最新的 Work IQ MCP 服务器，例如 Work IQ Teams。

可用工具

mcp_CalendarTools_graph_acceptEvent

在用户的日历中接受指定的事件邀请。

所需参数：

  • eventId：要接受的事件的 ID

可选参数：

  • userId：用户 ID 或 userPrincipalName
  • 注释：响应中包含的可选文本
  • sendResponse：是否向组织者发送响应

mcp_CalendarTools_graph_cancelEvent

取消指定用户的日历中的事件并通知与会者。

所需参数：

  • eventId：要取消的事件的唯一标识符

可选参数：

  • userId：用户 ID 或 userPrincipalName
  • 注释：可选取消消息

mcp_CalendarTools_graph_createEvent

在指定的用户的日历中创建新的日历事件。 支持定期事件和在线会议。

所需参数：

  • 主题：事件主题/标题（nonempty）
  • start：包含 dateTime 和 timeZone 的开始时间戳
  • end：使用dateTime和timeZone来结束时间戳
  • attendees_addresses：与会者电子邮件地址数组

可选参数：

  • userId：用户 ID 或 userPrincipalName
  • body: 包含 contentType 的事件正文（文本/HTML）和内容
  • location：包含 displayName 的位置
  • attendees_types：与会者角色（必需、可选、资源）
  • attendees_names：与会者显示名称
  • 重复：重复模式和范围
  • isOnlineMeeting：设置为true用于在线会议
  • onlineMeetingProvider：teamsForBusinessskypeForBusinessskypeForConsumer
  • allowNewTimeProposals：允许时间建议（默认值：true）
  • transactionId： Idempotence 标识符

mcp_CalendarTools_graph_declineEvent

在用户的日历中拒绝指定的事件邀请。

所需参数：

  • eventId：要拒绝的事件的 ID

可选参数：

  • userId：用户 ID 或 userPrincipalName

  • 注释：响应中的可选文本

  • sendResponse：是否发送响应

mcp_CalendarTools_graph_deleteEvent

从指定的用户的日历中删除事件。

所需参数：

  • eventId：要删除的事件的唯一标识符

可选参数：

  • userId：用户 ID 或 userPrincipalName

mcp_CalendarTools_graph_findMeetingTimes

根据组织者和与会者的可用性建议会议时间和位置。

所需参数：

  • meetingDuration：会议持续时间（例如“PT1H”）

可选参数：

  • userId：组织者 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 的开始时间
  • endTime：包含 dateTime 和 timeZone 的结束时间

可选参数：

  • userId：用户 ID 或 userPrincipalName
  • availabilityViewInterval：时间段长度（以分钟为单位）

mcp_CalendarTools_graph_listCalendarView

检索用户在指定时间范围内的日历事件。

所需参数：

  • startDateTime：时间范围的开始时间（ISO 8601）
  • endDateTime：时间范围结束（ISO 8601）

可选参数：

  • userId：用户 ID 或 userPrincipalName
  • top：事件数上限
  • orderby：按子句排序

mcp_CalendarTools_graph_listEvents

从指定用户的日历中检索事件列表。

可选参数：

  • userId：用户 ID 或 userPrincipalName
  • startDateTime：时间范围的开始时间（ISO 8601）
  • endDateTime：时间范围结束（ISO 8601）
  • top：最大事件数
  • filter：OData 筛选器查询
  • orderby：OData 排序依据查询

mcp_CalendarTools_graph_updateEvent

更新指定用户的日历中的现有日历事件。

所需参数：

  • eventId：事件的唯一标识符

可选参数：

  • userId：用户 ID 或 userPrincipalName
  • 主题：更新的主题
  • body：更新的正文内容
  • start：更新的开始时间
  • end：更新的结束时间
  • 位置：更新的位置
  • attendees_addresses：更新的与会者电子邮件
  • attendees_types：更新的与会者类型
  • attendees_names：更新的与会者姓名
  • isCancelled：设置为 true 以取消
  • 重复性：更新后的重复模式

主要功能

事件管理

  • 创建、阅读、更新和删除事件
  • 接受、拒绝和取消邀请
  • 支持定期事件
  • 与联机会议集成 （Teams， Skype）

可用性和计划

  • 获取空闲/忙碌时间表
  • 使用可用性检查查找会议时间
  • 具有时间范围筛选的日历视图
  • 与会者可用性分析

与会者管理

  • 管理必需、可选和资源型与会者
  • 对时间建议的支持
  • 跟踪响应
  • 对通讯组列表的支持

重复模式

  • 每日、每周、每月和每年。
  • 绝对和相对重复周期
  • 结束日期或事件发生计数
  • 星期几和月份格式规范

线上会议

  • 与 Teams for Business 集成
  • 支持Skype for Business
  • 支持Skype（供个人使用）
  • 自动会议链接生成

Notes

  • 所有时间戳使用附带时区信息的 UTC/ISO 8601 格式。
  • 日历 MCP 依赖于 UserprofileMCP 以查找组织中的用户
  • 电子邮件必须采用有效格式。
  • 与会者数组（地址、类型、姓名）必须按相同顺序
  • 在线会议需要 isOnlineMeeting=true 和 onlineMeetingProvider
  • 重复性要求同时具有模式对象和范围对象
  • 时区应在开始和结束时间之间保持一致
  • TransactionId 支持 idempotent 事件创建
  • Last updated on