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支持更新时的并发控制。