---
title: "安装 Gmail 插件"
summary: "安装 gmail@openai-curated 并连接 Google 账号，用于检索邮件和起草回复。发送邮件前确认收件人及内容。"
category: skills
level: starter
surfaces: [cli, app]
tags: ["plugins", "Gmail", "gmail@openai-curated", "Google"]
canonical: /tips/gmail-codex-plugin/
---

# 安装 Gmail 插件

安装 gmail@openai-curated 并连接 Google 账号，用于检索邮件和起草回复。发送邮件前确认收件人及内容。

安装 gmail@openai-curated 并连接 Google 账号，用于检索邮件和起草回复。发送邮件前确认收件人及内容。

这是 OpenAI 做的 Gmail 插件，用来搜已连接收件箱里的邮件和会话，并在工作区打开写动作时起草回复、整理线程。产品页是 [Gmail](https://openai.com/business/plugins/gmail/)。Google 权限边界看 [Google app data controls FAQ](https://help.openai.com/en/articles/10408842-google-app-data-controls-faq)。清单 [`plugin.json`](https://github.com/openai/plugins/blob/main/plugins/gmail/.codex-plugin/plugin.json) 的 name 是 `gmail`，所以精选 id 是 `gmail@openai-curated`。仓库 README 写明本包没有随附技能。

CLI：

```bash
codex plugin add gmail@openai-curated
codex plugin list
```

TUI `/plugins` 或桌面 Plugins 搜 Gmail 再装，效果一样。装完按提示 Connect Google 账号。IDE 扩展没有 `/plugins`，用 CLI 这条。

插件 [`.mcp.json`](https://github.com/openai/plugins/blob/main/plugins/gmail/.mcp.json) 表名是 `gmail`，type 是 http，URL 是 `https://gmailmcp.googleapis.com/mcp/v1`（带 `/mcp/v1`）。插件已经登记 MCP 时，不要再手写 `mcp add gmail --url https://gmailmcp.googleapis.com/mcp/v1` 叠一张。OAuth 字段由插件带，不要手抄 client_id，

帮助中心写明：只能读你授权的那个 Google 账号已经能打开的邮件。Gmail 动作对应的管理端 scope 是 `gmail.modify`。工作区没打开写动作、或 Google Workspace 没批准对应 scope 时，连接或发信会失败。ChatGPT Work 里「新邮件触发任务」是网页事件触发，不能拿来代替这条 Codex 插件安装。未确认前不要发送。

在支持的 Codex 任务视图里，打开 Sources → Use plugins，再搜已安装的 Gmail。ChatGPT 里可以用 `@Gmail`。

0.154 起先看**当前会话**的 `/plugins`；没有再新开。`codex plugin list` 里应看到 `gmail@openai-curated`。网页 Cloud 不读 `~/.codex/config.toml`。Cloud 用 Plugins 搜 Gmail。

使用注意事项：

- 操作影响：起草回复、改标签、归档会动真实邮箱。


## 来源

- [OpenAI · Gmail](https://openai.com/business/plugins/gmail/)
- [openai/plugins · gmail plugin.json](https://github.com/openai/plugins/blob/main/plugins/gmail/.codex-plugin/plugin.json)
- [openai/plugins · gmail .mcp.json](https://github.com/openai/plugins/blob/main/plugins/gmail/.mcp.json)