邮件 MCP
让数字人能够收发邮件、搜索邮箱、管理日历——把邮箱和日历变成数字人可操作的工具。
概述
邮件 MCP（halo-email）是 Halo 内置的邮件集成服务，基于标准的 IMAP / SMTP / CalDAV 协议，兼容绝大多数邮件服务商。
启用后，数字人可以：
- 收取、阅读、搜索邮件
- 发送、回复、转发邮件
- 管理邮件（移动、标记已读/未读、删除）
- 查看文件夹结构和附件
- 查询、创建、删除日历事项（需配置 CalDAV）
第一步：配置邮件账号
邮件 MCP 的账号凭据来自 设置 → 消息通道 → Email 中的邮件通道配置。
需要填写：
| 字段 | 说明 |
|---|---|
| IMAP 服务器 | 接收邮件，如 imap.gmail.com:993 |
| SMTP 服务器 | 发送邮件，如 smtp.gmail.com:465 |
| 用户名 / 密码 | 邮箱账号和密码（或应用专用密码） |
| CalDAV URL（可选） | 日历服务地址，填写后启用日历工具 |
常见邮件服务
- Gmail：需在账户设置中开启 IMAP，并使用"应用专用密码"
- 企业邮箱（Exchange/Outlook）：联系 IT 获取 IMAP/SMTP 地址
- 腾讯企业邮：
imap.exmail.qq.com:993/smtp.exmail.qq.com:465 - 网易企业邮：
imap.qiye.163.com:993/smtp.qiye.163.com:994
第二步：为数字人开启邮件能力
邮件 MCP 默认不开启，需要为每个数字人单独启用：
- 打开数字人详情页，进入 设置（Settings） 标签
- 在 Runtime 区域找到 Email 开关
- 打开开关
开关是灰色的？
说明邮件账号还未配置。点击页面上的提示链接 "Go to Settings → Notification Channels" 先完成邮件账号配置，再回来开启。
可用工具
启用后，数字人可以使用以下工具：
邮件工具（11 个）
| 工具 | 功能 |
|---|---|
email_list | 列出收件箱或指定文件夹的邮件 |
email_read | 读取单封邮件的完整内容 |
email_search | 全文搜索邮件 |
email_send | 发送新邮件 |
email_reply | 回复邮件 |
email_forward | 转发邮件 |
email_move | 将邮件移动到其他文件夹 |
email_mark | 标记已读、未读、星标等 |
email_delete | 删除邮件 |
email_folders | 列出所有文件夹/标签 |
email_attachment | 读取邮件附件内容 |
日历工具（3 个，需配置 CalDAV）
| 工具 | 功能 |
|---|---|
calendar_list | 列出指定时间范围内的日历事项 |
calendar_create | 创建新日历事项 |
calendar_delete | 删除日历事项 |
使用场景
个人邮件助理
每天早上汇总未读邮件，按优先级分类，把重要邮件摘要发系统通知给我日程管理
帮我查看本周的会议安排，如果周三下午有空，帮我创建一个和李明的 1:1 会议自动化邮件处理
监听 support@company.com，对客户投诉类邮件自动回复确认收到，
并创建 JIRA 工单（需配置 JIRA MCP）合同/文档提取
搜索过去一个月来自 xxx@vendor.com 的邮件，
把所有带附件的邮件列出来，帮我整理成表格IM 渠道中的邮件权限
在 IM 渠道（企业微信机器人等）中，访客能否触发邮件工具受权限控制的 Email 开关约束。
默认对访客关闭，如需开启请在 设置 → 消息通道 → Permission Control → Halo Capabilities 中开启 Email。
详见 → 安全与权限控制