邮件引用（预览）

注释

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

Important

这是一项预览功能。

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

概述

服务器 ID 租户级 URL 显示名称 Description
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： 包含电子邮件地址的收件人数组
  • 消息正文： 包含内容类型（Text/HTML）和内容的消息正文

可选参数：

  • preferHtml： 对于 HTML 内容，设置为 true
  • 标头： 可选附加标头

mcp_MailTools_graph_mail_deleteMessage

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

所需参数：

  • id： 消息 ID

可选参数：

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

mcp_MailTools_graph_mail_getMessage

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

所需参数：

  • id： 消息 ID

可选参数：

  • select：OData 选择子句
  • expand： OData expand 子句
  • preferHtml： 请求 HTML 正文格式
  • 标头： 可选的 HTTP 标头

mcp_MailTools_graph_mail_listSent

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

可选参数：

  • filter： OData 筛选器
  • 搜索： 搜索查询
  • orderby： 排序表达式
  • top： 要返回的项目数
  • select： 要返回的字段

mcp_MailTools_graph_mail_reply

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

所需参数：

  • id： 要答复的消息 ID

可选参数：

  • 注释： 回复文本
  • message：可选消息覆盖
  • preferHtml： 启用 HTML 格式
  • 标头： 可选的 HTTP 标头

mcp_MailTools_graph_mail_replyAll

对现有消息发送全体回复。 支持通过 preferHtml 或 headers.

所需参数：

  • id：用于群发回复的消息 ID

可选参数：

  • 注释： 回复文本
  • message：可选消息覆盖
  • preferHtml： 启用 HTML 格式
  • 标头： 可选的 HTTP 标头

mcp_MailTools_graph_mail_searchMessages

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

所需参数：

  • 请求： 搜索请求数组，参数为 entityTypes、查询、起始位置、大小

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

mcp_MailTools_graph_mail_sendDraft

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

所需参数：

  • id： 要发送的消息 ID 草稿

mcp_MailTools_graph_mail_sendMail

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

所需参数：

  • 消息： 带有主题、toRecipients和主体的消息对象
  • 主题： 电子邮件主题
  • toRecipients： 主要收件人
  • 正文： 包含参数 contentType（文本/HTML）和内容的电子邮件正文

可选参数：

  • ccRecipients：抄送收件人
  • 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 支持对更新操作进行并发控制。
  • Last updated on