用 MCP 把 ChatGPT 连接到你的邮箱(Gmail、iCloud 和 IMAP)
分步指南:用自定义 MCP 连接器把 Gmail、iCloud、Fastmail 或任意 IMAP 收件箱接入 ChatGPT,并用受限密钥接入 OpenAI Codex。不存储任何邮件。
Outlook 与 Microsoft 365 仍在开发中。 目前还无法在生产环境中连接。本指南涵盖 Gmail、iCloud、Fastmail、Yahoo、Zoho 以及今天已经可用的其他 IMAP 邮箱。
ChatGPT 无法自行访问邮箱。它需要在你的邮件前面有一台 MCP 服务器,而 MCP Emails 就是这台服务器:连接一次收件箱,把 ChatGPT 指向一个 URL,无论邮件存放在 Gmail、iCloud、Fastmail、Yahoo、Zoho 还是自建的 IMAP 服务器上,它拿到的都是同一套邮件工具。
这里涉及两个 OpenAI 平台,它们的认证方式不同。ChatGPT 在浏览器里走 OAuth 流程,所以没有 API 密钥需要粘贴。OpenAI Codex 运行在终端里,因此改用一个受限的 bearer 密钥。端点相同,工具相同。
你需要准备什么
- 一个可以创建自定义连接器的 ChatGPT 工作区。 支持任意 MCP 连接器的开发者模式是 OpenAI 的测试功能,仅限 ChatGPT Business、Enterprise 和 Edu 工作区。在个人账户上,这个选项要么不存在,要么会拒绝该服务器,我们这边无法解锁它。
- 一个免费的 MCP Emails 账户。 在此创建。免费方案可连接一个收件箱,无需信用卡。
- 一个邮箱。 Gmail、iCloud、Fastmail、Yahoo、Zoho、Yandex,或任何支持 IMAP 与 SMTP 的邮箱。
如果你的工作区暂时还不能创建连接器,同一个收件箱和同一个 URL 已经可以在 Claude、Cursor、VS Code 以及其他受支持的客户端中使用。
第 1 步:把收件箱连接到 MCP Emails
在 MCP Emails 控制台中,打开 Inboxes,再点 Connect Inbox,然后选择你的服务商。
Gmail 与 Google Workspace
Gmail 默认通过 Google 应用专用密码以 IMAP 方式连接,同时也支持 Google OAuth 登录。如果 Workspace 管理员限制了第三方应用访问,请使用应用专用密码。Gmail 操作指南列出了具体步骤。
iCloud、Fastmail、Yahoo 与 Zoho
这些服务商要求应用专用密码,而不是你在网页上输入的登录密码。先在服务商处生成一个,在 MCP Emails 中选择对应服务商,然后粘贴进去。iCloud、Fastmail 与 IMAP 指南给出了准确步骤。
其他任意 IMAP 邮箱
选择 IMAP,填入邮箱地址和应用专用密码。常见设置会被自动识别;自定义域名可能需要你从服务商处获取主机、端口和加密方式。服务商对照表列出了每家支持的功能,connect 下每家服务商还有独立页面,包括 Gmail、iCloud 和通用 IMAP。
如果你的方案允许,可以连接多个邮箱。ChatGPT 会通过 inbox_list 发现它们,所以你永远不需要把邮箱 id 粘进提示词里。
第 2 步:在 ChatGPT 中添加连接器
- 在 ChatGPT 设置中打开开发者模式,位置在应用与连接器的高级设置里。
- 新建一个连接器并为它命名。
- 粘贴这个连接器 URL:
https://mcpemails.com/api/mcp
- 认证方式选择 OAuth,创建连接器,然后用 MCP Emails 完成授权。
请选择 OAuth,不要选"无需认证"。本服务器会拒绝匿名调用,因此一个在创建时未配置认证的连接器,设置阶段看起来一切正常,却会在第一次工具调用时失败,这种先后顺序最容易让人困惑。使用 OAuth 时,ChatGPT 会自行注册并完成带 PKCE 的授权码流程:不需要创建 client id,任何地方都不需要客户端密钥。OpenAI 在测试期间会不断调整菜单措辞,因此请查看 ChatGPT 设置页获取当前路径。
第 3 步:只授予你需要的权限
同意授权页面来自我们,而不是 OpenAI。首次授权从 read:email 开始,这已经足以做分拣、摘要和查找,并且在你决定要放开多少权限之前,它把所有不可撤销的操作都排除在外。其他权限分别是 send:email、search:email 和 manage:automations。
授权给得太少是可以补救的:当某次调用需要令牌所缺的权限时,会返回 403 和一个权限不足的错误,客户端可以针对该权限重新请求授权并重试。收件箱所有者还可以在控制台中要求人工审批,它会把每一次发送、回复、转发、草稿发送和定时发送都扣住,直到有人放行。
第 4 步:给 ChatGPT 一个安全的首个任务
从只读开始:
总结我最新的三封未读邮件,并标出今天需要回复的内容。不要发送、移动或删除任何东西。
ChatGPT 会先找到收件箱,然后只读取它需要的邮件。这一步跑通后,可以再试试:
- "找到上个月来自 Stripe 的账单,并告诉我金额。"
- "给 Alex 最新的那封邮件写一份回复,但只存为草稿。"
- "列出本周可以归档的新闻订阅邮件,等我确认后再处理。"
如果要做可复用的例行流程,可以从收件箱分拣手册或工作流提示词合集开始。
连接完成后 ChatGPT 能做什么
MCP Emails 交给 ChatGPT 的是一组聚焦的邮件工具,而不是一个密码或一条原始的 IMAP 连接:
- 读取与搜索:
email_read涵盖 list、read、read_batch、search 和 attachment。Gmail 搜索支持from:、is:unread等操作符。 - 发送、回复与转发:
email_compose通过你自己的服务商和地址发送。 - 整理:
email_organize、email_search_and_move和email_delete。 - 草稿、文件夹与定时:
draft、draft_list、folder、folder_list、schedule和schedule_list。 - 其余:
contact_search、signature_get、signature_set,以及用于周期性规则的automation和automation_read。
有一个限制需要提前考虑:MCP Emails 基于轮询。没有 webhook,也没有服务器主动发起的事件,所以 ChatGPT 只在你要求时才去查看新邮件,而不是邮件一到就知道。
终端里的 OpenAI Codex
Codex 与 ChatGPT 连接器是不同的平台,浏览器 OAuth 流程在这里不适用。终端客户端改用 bearer 令牌认证:
- 在控制台中打开 API Keys 并创建一个密钥。只勾选这个智能体确实需要的权限。
- 立即复制密钥。它形如
mcpe_后跟 64 位十六进制字符,并且只显示一次。 - 在 Codex 自己的 MCP 服务器配置中,把
https://mcpemails.com/api/mcp注册为可流式传输的 HTTP MCP 服务器,并通过Authorization: Bearer请求头传入该密钥。
密钥连接与 OAuth 连接访问的是同一个端点,看到的也是同一份工具清单。唯一的区别在于令牌从哪里来。如果想先验证端点,原始 HTTP 指南提供了一行 tools/list 调用,而 OAuth 与 API 密钥的对比解释了两条路径各自适用的场景。
请把密钥权限收紧。对编码智能体来说,只读通常是正确的选择:一个能总结支持工单的智能体很有用,一个能在无人看管时发邮件的智能体则属于完全不同的风险等级。
常见问题排查
- 没有创建自定义连接器的选项。 开发者模式仅限 Business、Enterprise 和 Edu 工作区。这是 OpenAI 的产品决策,不是服务端设置。
- 连接器在第一次工具调用时失败。 它多半是在未配置认证的情况下创建的。删除它,用 OAuth 重新创建。
- 服务商拒绝你的密码。 请使用服务商生成的应用专用密码,而不是网页登录密码。部分服务商只有在开启双重验证后才会签发。
- 自定义 IMAP 连接超时。 确认主机、端口和 TLS 模式。993 端口通常使用隐式 TLS,143 端口通常使用 STARTTLS。
- ChatGPT 连上了却看不到邮件。 检查该收件箱在控制台中是否处于启用状态,确认连接拥有
read:email权限,并让 ChatGPT 先调用inbox_list。
常见问题
ChatGPT 能读取并发送我的邮件吗? 通过自定义 MCP 连接器可以:读取、搜索、发送、回复、转发、整理和定时发送,全部受限于你在设置时批准的权限范围。
用 ChatGPT 需要 API 密钥吗? 不需要。选择 OAuth,ChatGPT 会自行注册并完成流程。API 密钥面向无法运行浏览器流程的客户端,例如 Codex 和脚本。
Codex 的设置方式相同吗? 不同。Codex 是终端平台,所以它用 Authorization: Bearer 请求头里的受限 API 密钥,而不是浏览器 OAuth 流程。端点相同,工具相同。
我的邮件会存在你们的服务器上吗? 不会。每封邮件都是为发起该请求的那次调用从你的服务商实时获取,随后即被丢弃。只有加密后的服务商凭据会被保留。为什么"不存储邮件"很重要解释了背后的理由。
价格是多少? 免费方案包含一个已连接收件箱,以及每个 UTC 自然月 150 次计费邮件操作,前 7 天不计入。该月度上限适用于 2026 年 9 月 13 日及之后创建的工作区,更早创建的工作区不受此限制。Personal 每月 $5,可连接 3 个收件箱,没有月度操作上限;Pro 每月 $15,收件箱数量不限。详见价格。
下一步
免费开始,连接一个收件箱,把 https://mcpemails.com/api/mcp 添加到 ChatGPT,然后让它总结你的未读邮件。ChatGPT 设置页有当前的操作路径,文档提供完整的工具参考。