邮件引用(预览)

Note

本文介绍了由 标准线束驱动的代理或代理流中使用的功能。

Important

这是一项预览功能。

  • Microsoft正式发布之前发布预览版功能,以便客户能够提前访问并提供反馈。
  • 预览功能具有受限的功能,不适用于生产用途。
  • Microsoft可能会更改预览 MCP 工具名称和参数。 避免硬编码依赖项。 Microsoft 提供场景支持。
  • 预览功能受Microsoft补充使用条款的约束。

Note

针对特定应用的 Microsoft 365 MCP 工具(Copilot、日历、邮件、SharePoint、OneDrive、Teams、User 和 Word)仅用于向后兼容,不应用于生产环境或新项目。 对于需要访问 Microsoft 365 资源的新项目,请使用 Work IQ MCP 配合 Microsoft Copilot harness。 更多信息请参见 Copilot Studio 中的 Work IQ MCP。

Overview

服务器 ID 租户级 URL 显示名称 说明
mcp_MailTools https://agent365.svc.cloud.microsoft/agents/
tenants/{tenantId}/servers/mcp_MailTools
邮件 用于Microsoft Graph邮件操作的工具,包括创建、发送、回复和管理电子邮件。

可用工具

mcp_MailTools_graph_mail_createMessage

创建草稿电子邮件。 通过设置 body.body.contentType = "HTML"支持HTML 。

所需参数:

  • 主题: 信息主题
  • toRecipients: 带有电子邮件地址的收件人数组
  • 正文: 消息正文,包含内容类型(文本/HTML)和内容

可选参数:

  • preferHtml: HTML内容设置为true。
  • 标头: 可选的额外标头

mcp_MailTools_graph_mail_deleteMessage

从已登录用户的邮箱中删除邮件。

所需参数:

  • ID: 消息ID

可选参数:

  • If-Match: 可选 ETag 用于并发控制

mcp_MailTools_graph_mail_getMessage

通过 ID 从已登录用户的邮箱中获取邮件。 使用 preferHtml 请求 HTML 正文。

所需参数:

  • ID: 消息ID

可选参数:

  • 选择: OData选择子句
  • 扩展: OData扩展子句
  • preferHtml: 请求HTML正文格式
  • 头部: 可选的 HTTP 头部

mcp_MailTools_graph_mail_listSent

在已发送的邮件中列出消息。

可选参数:

  • 滤波器: OData滤波器
  • search: 搜索查询
  • orderby: 排序表达式
  • top: 要返回的项目数量
  • 选择: 返回字段

邮件工具图表邮件回复

发送对现有邮件的答复。 支持通过 preferHtml 或 headers.

所需参数:

  • ID: 要回复的消息 ID

可选参数:

  • 评论: 回复正文
  • 消息: 可选消息将替代原消息
  • preferHtml: 启用HTML格式化
  • 头部: 可选的 HTTP 头部

mcp_MailTools_graph_mail_回复所有

向现有邮件发送全部答复。 支持通过 preferHtml 或 headers.

所需参数:

  • id: 回复所有人的消息ID

可选参数:

  • 评论内容: 回复文本
  • 消息: 可选消息会覆盖原内容
  • preferHtml: 启用HTML格式化
  • 头部: 可选的 HTTP 头部

mcp_MailTools_graph_mail_searchMessages

使用 Microsoft Graph Search API 和关键字查询语言 (KQL) 样式的查询来搜索 Outlook 邮件。

所需参数:

  • 请求: 带有 entityTypes、query、from、size 参数的搜索请求数组

支持搜索邮件内容、主题、正文和附件

mcp_MailTools_graph_mail_sendDraft

通过 ID 发送现有草稿消息。

所需参数:

  • ID: 要发送的草稿消息 ID

mcp_MailTools_graph_mail_sendMail

以登录用户的身份发送电子邮件。

所需参数:

  • 消息: 带有主题、toRecipients和正文的消息对象
  • 主题: 邮件主题
  • 收件人: 主要收件人
  • 正文: 邮件正文,内容类型(文本/HTML)和内容

可选参数:

  • 抄送收件人: 复印收件人
  • bccRecipients: 密件抄送收件人
  • saveToSendItems: 保存至发送物品(默认:true)
  • preferHtml: 强制 HTML 渲染
  • 头部: 可选的额外HTTP头部

10. mcp_MailTools_graph_mail_updateMessage

更新邮件的可变属性,例如主题、正文和类别。

所需参数:

  • ID: 消息ID

可选参数:

  • 主题: 新主题
  • 正文: 新消息正文
  • 分类: 消息分类
  • 重要性: 低、普通或高
  • If-Match:ETag 用于并发控制

主要功能

电子邮件撰写

  • 创建草稿并发送电子邮件
  • HTML 和纯文本支持
  • 收件人、抄送和密件抄送收件人
  • 丰富的格式选项

电子邮件管理

  • 获取、更新和删除消息。
  • 回复和全部回复功能。
  • 草稿管理。
  • 类别和重要性设置。

搜索和筛选

  • KQL 样式的邮件搜索。
  • OData 查询支持。
  • 跨主题、正文和附件进行搜索。
  • 分页和筛选。

Sentitems

  • 列出发送的消息。
  • 可选择保存到已发送邮件
  • 筛选和搜索已发送的项目。

备注

  • 所有操作都使用Microsoft Graph邮件 API。
  • HTML 内容的正文中需要包含 contentType = "HTML"。
  • preferHtml 首部请求 HTML 正文格式。
  • 搜索功能使用 Microsoft Graph Search API 和 KQL 查询。
  • 可以单独创建、更新和发送草稿邮件。
  • ETag 支持更新时的并发控制。