用途:email-mcp 是一个统一 MCP 服务器,让 AI 助手通过 MCP 协议访问多个邮箱账户,支持 Gmail(REST API)、Outlook(Microsoft Graph)、iCloud(IMAP)和通用 IMAP/SMTP。
主要能力:提供 36 个工具,涵盖账户管理、读取与搜索、发送与草稿、组织、批量操作、垃圾邮件管理和转发规则。支持 OAuth2 浏览器登录与自动刷新令牌;默认返回紧凑搜索结果(约 20KB,而非约 1.4MB),可选获取完整正文;批量删除、移动或标记数百封邮件;附件支持路径或 base64,总量上限 25MB(Outlook 单封 3MB)。
使用方式:通过 npm 全局安装或 npx 运行,先执行交互式设置向导添加账户,再将服务器加入 MCP 配置(如 .mcp.json)。Gmail 和 Outlook 使用内置 OAuth 凭据,也可配置自有 OAuth 应用;iCloud 需生成 App 专用密码;通用 IMAP 需提供服务器信息。
限制与安全:凭据以 AES-256-GCM 加密存储于 ~/.email-mcp/credentials.enc,可用 EMAIL_MCP_KEY 自定义密钥。附件仅能从 EMAIL_MCP_ATTACHMENTS_DIR 指定目录读取;转发规则仅接受 EMAIL_MCP_FORWARD_ALLOWLIST 中的地址。转发规则和垃圾邮件规则工具仅支持 Gmail 与 Outlook,iCloud/IMAP 无服务端规则机制。Gmail 共享 OAuth 应用截至 2026 年 10 月 1 日仍在 Google 审核中,仅测试用户可登录,其他用户需自建 OAuth 应用。该工具免费,无付费层级;Google 年度安全评估(CASA)费用为每年 675 美元,通过捐赠筹集。