给 Gemini CLI 一个专属邮箱
通过 Remote MCP 和 OAuth 把 Gemini CLI 连接到 Mailly 邮箱,让它读信、保存回复草稿,并在你确认后发送。
Gemini CLI 可以直接处理一个真实邮箱:搜索会话、读取来信、保存回复草稿,并在你确认最终正文后发送。Mailly 给它一个 your-name@mailly.site 这样的地址,通过 Remote MCP 连接。Gemini CLI 会自动发现 Mailly 的 OAuth 配置,不需要设置 client ID。
2026 年 6 月 18 日起,Google 已用 Antigravity CLI 取代面向免费层和 Google One 用户的 Gemini CLI,见 Google 的公告。本指南介绍的是 Gemini CLI。
你会得到
- 一个可收可发的
@mailly.site邮箱;Developer 套餐还可以使用自己的域名。 - 约 70 个类型明确的 MCP 工具,覆盖会话、草稿、发信、域名、联系人、模板、Campaign 和 Workflow,并受你授予的授权范围限制。
- 发信由你把关:Gemini CLI 会展示确切的正文和收件人,Mailly 在你确认后才发送。
开通邮箱
已有 Mailly 账户可跳过这一步。
把下面的提示词粘贴到 Gemini CLI。它会读取 Mailly 的开通说明,询问你想要的名称,通过 HTTP 预留,再把验证链接交给你。
Read https://mailly.site/auth.md
and set up a Mailly inbox for me over HTTP.
Ask me for the name if unknown; if taken, ask for another,
with no blind retries.
Send me the verification link.
After I confirm the inbox in my browser,
store the API key securely, tell me the address,
and ask me before sending any email.打开链接,用你自己已验证的邮箱登录或注册,然后确认这个邮箱。之后 Gemini CLI 会拿到邮箱地址和你账户的 API Key。也可以直接在 mailly.site/onboard 开始。规则见让 Agent 帮你开通邮箱。
添加 Mailly MCP 服务器
gemini mcp add --transport http --scope user mailly https://mcp.mailly.site/mcp--scope user 写入 ~/.gemini/settings.json,在所有目录可用。默认范围是 project,写入当前目录的 .gemini/settings.json。手动编辑时,Mailly 的 Streamable HTTP 端点要用 httpUrl(在 Gemini CLI 中 url 表示 SSE):
{
"mcpServers": {
"mailly": {
"httpUrl": "https://mcp.mailly.site/mcp"
}
}
}登录并选择授权范围
不要填写任何 OAuth 设置。首次连接时 Mailly 返回 401,Gemini CLI 会发现授权服务器,通过动态客户端注册完成注册,然后打开浏览器。登录 Mailly,并决定 Gemini CLI 能做什么:
| 授权范围 | Gemini CLI 可以 |
|---|---|
mail:read | 读取邮箱、会话、已发邮件、草稿和设置。始终授予。 |
mail:draft | 保存、修改、放弃回复草稿;不能发送。 |
mail:send | 发送你审核过的回复、转发和新邮件。 |
workspace:manage | 管理地址、域名、模板、联系人、Campaign、Workflow 和 Webhook。 |
Gemini CLI 把令牌保存在 ~/.gemini/mcp-oauth-tokens.json,过期时自动刷新。
验证连接
- 运行
gemini mcp list,它会显示每个服务器的配置和连接状态。在会话中,/mcp显示同样的信息。 - 对 Gemini CLI 说:“用 Mailly 列出我的邮箱地址和最近 5 个会话。” 它应调用
mailly_list_inbox_addresses和mailly_list_threads。 - 用你的个人邮箱给 Mailly 地址发一封邮件,然后说:“读取我在 Mailly 的最新会话并保存一份回复草稿,给我看确切正文,先不要发送。” Gemini CLI 会调用
mailly_read_thread和mailly_save_draft。在对话中批准或放弃这份草稿。
改用 CLI
OAuth 需要本地浏览器,在 SSH 或无交互环境中无法完成。这种情况下,可以在 Gemini CLI 的 shell 中使用 mailly-cli。mailly login --no-browser 会打印登录链接,可在另一台设备上打开。
npm install -g mailly-cli # Node.js 18+
mailly login --no-browser
mailly inbox addresses list --json
mailly inbox threads list --json常见问题
- Mailly 显示未连接或需要登录:运行
/mcp auth mailly重新认证。 - 手动添加后连接出错:确认配置使用的是
httpUrl而不是url。用url时 Gemini CLI 会尝试 SSE。 - 无法打开浏览器(SSH、容器):OAuth 需要本地浏览器,请按上文改用 CLI。
- 缺少某个工具:它需要你没有授予的权限。运行
/mcp auth mailly,在 Mailly 授权页勾选该权限。Mailly 不会自动扩大已有授权。 - 收不到邮件:在工作台确认地址,并查看收件箱的垃圾邮件文件夹。