跳到主要内容

让你的 AI Agent 连接 Gmail

让 AI 助手查找重要邮件、整理会话要点,并准备供你审阅的回复草稿。 选择 MCP 或 oo CLI + Skill 接入。

47 个工具OAuthMCP / oo CLI + Skill

每月 20,000 次免费应用调用(付费服务另计)

开始使用 Gmail ↓

开始使用 Gmail

通过 Google 账号授权连接 Gmail。

先确认资源访问权限

一个可以使用 Gmail 的 Google 账号。

连接 Gmail

登录 OOMOL,选择团队,在 Gmail 连接页使用支持的授权方式创建连接。确认连接处于活跃状态,然后在 MCP 配置或 oo CLI 登录中使用同一个团队。

连接 Gmail
  • 一个可以使用 Gmail 的 Google 账号。
  • 可执行操作取决于连接获得的权限。请在任务中明确要求保存草稿还是发送邮件。
选择接入方式

适合支持远程 HTTP MCP 和自定义认证请求头的客户端。

  1. 打开 MCP 配置页,登录并选择应用连接所在的团队。点击“复制 MCP 配置”获取密钥和请求头。
  2. 按下方 MCP 客户端说明添加配置,再重新连接客户端。
  3. 将只读验证任务复制到 AI 对话中执行。
配置 MCPMCP 客户端配置→

适合能运行终端命令并使用 oo Skill 的 Agent。

  1. 按照 Agent 安装页的说明,安装 oo CLI 和 oo Skill。
  2. 登录应用连接所在的 OOMOL 团队。使用 oo login --team <team-name>,将占位符替换为团队名称。
  3. 将只读验证任务复制到 Agent 对话中执行。
安装 oo CLI + SkillCLI 安装指南→

MCP 客户端配置

获取 MCP 配置

用 OOMOL 配置页中的密钥和团队名称替换占位符。请妥善保管凭证,并保留已有的其他服务配置。

通用 HTTP

在支持远程 Streamable HTTP MCP 和自定义请求头的客户端中,按下方参数添加远程 MCP 服务。完整密钥和团队信息从 OOMOL MCP 配置页获取;不同客户端的字段名称和配置格式可能不同。

URL
https://connector.oomol.com/v1/mcp
传输方式
Streamable HTTP
Authorization
Bearer <mcp-api-key>
x-oo-team-name
<team-name>

将占位符替换为自己的值。Authorization 使用 Bearer 加 MCP 密钥,x-oo-team-name 使用应用连接所在的团队名称。优先使用客户端的保密输入或环境变量功能。只填写 URL 而缺少这些请求头,配置仍不完整。

验证连接
  1. 在客户端重新连接服务,确认能够列出 connector_list_apps 等 OOMOL 工具。如果连接失败,检查服务地址和两个认证请求头。
  2. 在新的 AI 对话中执行只读验证任务,确认能读取目标资源及其数据。

检查是否出现 connector_list_apps、connector_search_actions 等 OOMOL 工具。它们用于发现和执行 Gmail 操作,各操作不一定单独出现在 MCP 工具列表中。 常见问题 →

验证第一次 Gmail 查询

将此只读任务复制到新的 AI 对话中执行。查询失败时,请查看常见问题。

选择接入方式

验证第一次 Gmail 查询

核对返回的资源标识是否与你的目标一致,并查看查询结果。

仅使用 OOMOL MCP。 检查当前配置的 OOMOL 团队中是否有活跃的 Gmail 连接。读取已连接邮箱的个人资料并报告邮箱地址。使用 newer_than:7d 搜索最近 7 天的邮件线程,最多返回 5 项。报告查询条件、线程 ID 和实际返回的摘要。分别说明无匹配和权限错误。不要读取完整邮件、标为已读、更改标签、创建草稿或发送邮件。

试试这些 Gmail 任务

替换方括号中的参数后复制任务。部分任务会修改数据,执行前请确认目标和操作。

选择接入方式

总结邮件会话

查找相关邮件,让 AI 提取决定、截止日期和待确认的问题。

仅使用 OOMOL MCP。 查找本周有关上线的邮件,总结已确定的事项和待确认的问题。

准备回复草稿

结合邮件内容和你的要求起草邮件,保存后再审阅。

仅使用 OOMOL MCP。 找到询问交付时间的邮件,按下周三交付起草回复,保存为草稿。

按标签整理邮件

查找符合条件的邮件,并使用 Gmail 标签分类。

仅使用 OOMOL MCP。 找到本周的发票邮件,加上我已有的“发票”标签。

发送跟进邮件

把要点整理成邮件,发送给指定收件人。

仅使用 OOMOL MCP。 给 [收件人] 发送邮件,主题为 [主题]:感谢对方参加会议,确认 [决定],并请对方在 [日期] 前完成 [下一步]。

Gmail 工具

Gmail 是 Google 提供的电子邮件服务。连接账号后,AI 助手可以在你授予的权限范围内使用支持的邮件操作。

搜索与读取邮件

按搜索条件查找邮件,读取邮件内容用于分析。

创建邮件草稿

将邮件保存为 Gmail 草稿,便于发送前审阅。

管理邮件标签

列出可用标签,并为选定的邮件添加标签。

47 个工具

Search Threads

按查询搜索 Gmail 线程,并返回轻量级线程摘要。除非你在查询中明确指定,否则垃圾邮件和废纸篓会被排除在外。

gmail.search_threads

List Threads

列出 Gmail 线程,支持可选的查询筛选和分页。除非你在查询中明确指定,否则垃圾邮件和废纸篓会被排除在外。

gmail.list_threads

Fetch Emails

列出 Gmail 消息,支持可选的查询、标签和分页过滤器。使用 `detail` 选择仅标识符、轻量摘要或完整规范化消息。

gmail.fetch_emails

Get Message

通过消息 ID 获取 Gmail 消息,输出为简化规范化格式。当您只需要主题、发件人、收件人、日期和正文时使用。

gmail.get_message

Fetch Message By Message Id

通过消息 ID 获取 Gmail 消息,响应格式可控。当您需要规范化完整消息载荷而不是简化的 `get_message` 输出时使用。

gmail.fetch_message_by_message_id

Download Attachment

使用消息操作返回的元数据下载 Gmail 消息附件,并将其上传到 Connector 文件传输存储。

gmail.download_attachment

Fetch Message By Thread Id

获取 Gmail 会话中的所有消息。使用此操作检查已知 `threadId` 的完整对话载荷。

gmail.fetch_message_by_thread_id

Get Profile

获取已连接的 Gmail 配置文件,包括邮箱总数和当前 `historyId`。使用返回的 `historyId` 作为通过 `list_history` 进行增量同步的检查点。

gmail.get_profile

Send Email

从已连接的 Gmail 账户发送电子邮件。至少需要一个收件人以及主题或正文之一。

gmail.send_email

Reply Email

回复 Gmail 会话中的指定邮件,并保留原邮件的回复头;可通过 to 覆盖 Reply-To 或 From 指定的收件人。

gmail.reply_email

Reply To Thread

回复现有的 Gmail 会话,同时保留 Gmail 的会话线程。当您希望回复保持在同一个对话中并可选地覆盖收件人时使用。

gmail.reply_to_thread

Create Draft

使用简化字段创建 Gmail 草稿,返回稳定的草稿 ID 以及当前邮件和会话 ID。

gmail.create_draft

Create Email Draft

创建 Gmail 草稿。通过 replyToMessageId 或 threadId 创建回复草稿时,需要邮箱读取权限;省略的主题和收件人继承自回复目标,显式主题须与目标匹配。

gmail.create_email_draft

List Drafts

列出 Gmail 草稿并支持分页,当 `verbose` 为 true 时,可选地将每个草稿充实为完整的消息详情。

gmail.list_drafts

Get Draft

通过草稿 ID 获取 Gmail 草稿。使用 `format` 参数控制返回多少消息详情。

gmail.get_draft

Update Draft

更新 Gmail 草稿。通过 replyToMessageId 或不同的 threadId 重建回复关联时,需要邮箱读取权限。回复主题须与目标匹配;仅编辑邮件头时保留 MIME 正文。省略 attachments 时保留附件,传入列表时替换全部附件,传入空数组时清空附件。空字符串会清空对应字段。拒绝对不支持的 MIME 结构进行内容编辑。

gmail.update_draft

Send Draft

使用草稿中已存储的收件人按原样发送现有的 Gmail 草稿。发送是即时的,此操作无法安排发送时间。

gmail.send_draft

Delete Draft

通过草稿 ID 永久删除 Gmail 草稿,而不是发送它。

gmail.delete_draft

List Labels

列出所有系统和用户创建的 Gmail 标签。使用此操作发现标签修改操作所需的内部标签 IDs。

gmail.list_labels

Get Label

获取 Gmail 标签的详细信息,包括名称、类型、可见性设置、计数和可选颜色。

gmail.get_label

Create Label

创建新的 Gmail 标签并返回其内部标签 ID。在后续的标签修改操作中使用返回的 ID。

gmail.create_label

Patch Label

修补用户创建的 Gmail 标签。用于对标签名称、可见性设置或颜色进行部分更新。

gmail.patch_label

Update Label

更新现有 Gmail 标签的属性,包括名称、可见性设置或颜色。

gmail.update_label

Delete Label

从邮箱中永久删除用户创建的 Gmail 标签。这会删除标签定义本身,而不仅仅是将其从一条消息中分离。

gmail.delete_label

Add Label To Email

在单个 Gmail 消息上添加和/或移除标签。提供至少一个标签变更,并使用来自 `list_labels` 的标签 IDs。

gmail.add_label_to_email

Batch Modify Messages

在一次请求中最多为 1,000 条 Gmail 消息添加和/或移除标签。用于批量归档、标记为已读或自定义标签工作流。

gmail.batch_modify_messages

Move To Trash

将 Gmail 消息移至废纸篓。消息在 Gmail 永久删除之前仍可恢复。

gmail.move_to_trash

Untrash Message

将之前丢弃的 Gmail 消息恢复到邮箱。

gmail.untrash_message

Modify Thread Labels

在 Gmail 会话中的每条消息上添加和/或移除标签。当标签更改应应用于整个对话时使用。

gmail.modify_thread_labels

Move Thread To Trash

将整个 Gmail 会话移至废纸篓,包括该对话中的所有消息。

gmail.move_thread_to_trash

Untrash Thread

恢复之前丢弃的 Gmail 会话及其消息。

gmail.untrash_thread

List History

在已知 `startHistoryId` 之后列出 Gmail 邮箱更改历史。用于增量同步,并将最新的返回 `historyId` 作为检查点。

gmail.list_history

List Filters

列出邮箱的 Gmail 过滤器。用于审计现有规则或避免创建重复项。

gmail.list_filters

Get Filter

通过过滤器 ID 获取 Gmail 过滤器,以便检查其条件和操作。

gmail.get_filter

Create Filter

创建 Gmail 过滤器,包含匹配条件和结果操作。用于自动整理收到的邮件。

gmail.create_filter

Delete Filter

按过滤器 ID 永久删除 Gmail 过滤器。

gmail.delete_filter

Get Language Settings

获取已连接账户的 Gmail 显示语言设置。

gmail.get_language_settings

Update Language Settings

更新已连接账户的 Gmail 显示语言设置。

gmail.update_language_settings

Get Vacation Settings

获取 Gmail 假期回复设置,包括是否启用自动回复及其当前内容。

gmail.get_vacation_settings

Update Vacation Settings

更新 Gmail 假期回复设置。使用此操作可配置外出自动回复及其生效时间窗口。

gmail.update_vacation_settings

Get Auto Forwarding

获取当前 Gmail 自动转发配置,包括启用状态、转发地址和处理方式。

gmail.get_auto_forwarding

List Forwarding Addresses

列出已在 Gmail 账户上注册的转发地址。

gmail.list_forwarding_addresses

Settings Get Imap

获取 Gmail IMAP 设置,包括 IMAP 是否已启用以及清除或文件夹大小设置如何配置。

gmail.settings_get_imap

Update Imap Settings

更新 Gmail IMAP 设置,包括启用状态、自动清除行为、清除行为或最大文件夹大小。

gmail.update_imap_settings

Settings Get Pop

获取 Gmail POP 设置,包括访问窗口和邮件处理方式。

gmail.settings_get_pop

Update Pop Settings

更新 Gmail POP 设置,包括访问窗口和处理行为。

gmail.update_pop_settings

Stop Watch

停止邮箱的 Gmail 推送监视通知。使用此操作可禁用之前通过 watch 端点创建的通知。

gmail.stop_watch

跨应用完成任务

把邮件决定保存到 Notion

把邮件讨论中的决定放到项目笔记中。

把客户邮件中的决定同步到飞书

将客户邮件中已确认的决定和待答复问题整理成摘要,发给项目团队。

常见问题

为什么连接成功却读不到资源?

使用包含活跃应用连接的 OOMOL 团队。应用授权、MCP 密钥和资源访问权限需要分别检查。根据工具实际错误核对资源标识和查询范围,分别报告空结果与访问错误,并妥善保管密钥。 Gmail 先核对邮箱地址。搜索为空时检查日期范围和查询条件;默认排除垃圾邮件和回收站。读到个人资料不代表具备邮件搜索权限,搜索条件需要 gmail.metadata 之外的相应权限。保存草稿和发送邮件分别属于写入操作。

可以让 AI 助手处理哪些 Gmail 任务?

可以总结邮件会话、准备回复草稿,或为符合条件的邮件添加标签。说明发件人、主题或日期范围,便于找到需要处理的邮件。

可以只保存草稿,不发送邮件吗?

可以。草稿和发送是不同的操作。请明确要求保存草稿,然后在 Gmail 中审阅。

需要提供 Gmail API Key 吗?

这个集成通过 Google OAuth 授权连接,不需要 Gmail API Key。

可以把邮件摘要保存到 Notion 吗?

可以,需要授权 Gmail 和 Notion 连接。说明要总结哪些邮件,以及在哪个父页面下创建摘要。