重要提示
你需要是边境预览计划的一部分,才能提前访问 Microsoft Agent 365。 边界将你直接与Microsoft最新的 AI 创新联系起来。 边境预览版受客户协议现有预览条款的约束。 由于这些功能仍在开发中,其可用性和功能可能会随时间而变化。
概述
| 服务器 ID | 显示名称 | Description |
|---|---|---|
| mcp_CalendarTools | Microsoft Outlook 日历 MCP 服务器(边界): | 日历工具的 MCP 服务器。 将此 MCP 服务器用于日历作,例如创建、更新、检索事件、管理邀请和检查可用性。 |
可用工具
mcp_CalendarTools_graph_acceptEvent
在用户的日历中接受指定的事件邀请。
必需参数
- eventId:要接受的事件的 ID
可选参数:
- userId: 用户 ID 或 userPrincipalName
- 注释: 响应中包含的可选文本
- sendResponse: 是否向组织者发送响应
mcp_CalendarTools_graph_cancelEvent
取消指定用户的日历中的事件并通知与会者。
必需参数
- eventId: 要取消的事件的唯一标识符
可选参数:
- userId: 用户 ID 或 userPrincipalName
- 注释: 可选取消消息
mcp_CalendarTools_graph_createEvent
在指定的用户的日历中创建新的日历事件。 支持定期事件和联机会议。
必需参数
- 主题: 事件主题/标题(非空)
- start: 使用 dateTime 和 timeZone 开始时间戳
- end: dateTime 和 timeZone 的结束时间戳
- attendees_addresses: 与会者电子邮件地址数组
可选参数:
- userId: 用户 ID 或 userPrincipalName
- body: 包含 contentType 的事件正文(文本/HTML)和内容
- 位置: 使用 displayName 的位置
- attendees_types: 与会者角色(必需、可选、资源)
- attendees_names: 与会者显示名称
- 定期: 定期模式和范围
- isOnlineMeeting: 设置为 true 进行联机会议
- onlineMeetingProvider: 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
根据组织者和与会者的可用性建议会议时间和位置。
必需参数
- meetingDuration: 会议持续时间(例如“PT1H”)
可选参数:
- userId: Organizer ID 或 userPrincipalName
- attendees_addresses: 与会者电子邮件地址
- attendees_types: 与会者类型
- attendees_names: 与会者显示名称
- timeConstraint: timelots 和 activityDomain 的时间可用性
- locationConstraint: 位置选项
- maxCandidates: 最大建议数
- isOrganizerOptional: Organizer 可选标志
- returnSuggestionReasons: 包括原因
- minimumAttendeePercentage: 最小出勤阈值
mcp_CalendarTools_graph_getEvent
从指定的用户的日历中获取单个日历事件。
必需参数
- EVENTID - 日志条目的事件标识符。
可选参数:
- userId: 用户 ID 或 userPrincipalName
- select: OData $select查询参数
- expand: 导航属性的 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: Order by 子句
mcp_CalendarTools_graph_listEvents
从指定用户的日历中检索事件列表。
可选参数:
- userId: 用户 ID 或 userPrincipalName
- startDateTime: 时间范围(ISO 8601)
- endDateTime: 时间范围结束(ISO 8601)
- 最大事件数。
- filter: OData 筛选器查询
- orderby: OData order by query
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 for Consumer 的支持
- 自动会议链接生成
注释
- 所有时间戳以 ISO 8601 格式返回 UTC 时间:
- 日历 MCP 依赖于 UserprofileMCP 查找组织中的用户
- 电子邮件必须采用有效格式。
- 与会者数组(地址、类型、姓名)必须按相同顺序
- 联机会议需要 isOnlineMeeting=true 和 onlineMeetingProvider
- 重复周期需要模式和范围对象
- 时区应在开始和结束时间之间保持一致
- TransactionId 启用幂等事件创建