验证第一次 Gmail 查询
核对返回的资源标识是否与你的目标一致,并查看查询结果。
仅使用 OOMOL MCP。 检查当前配置的 OOMOL 团队中是否有活跃的 Gmail 连接。读取已连接邮箱的个人资料并报告邮箱地址。使用 newer_than:7d 搜索最近 7 天的邮件线程,最多返回 5 项。报告查询条件、线程 ID 和实际返回的摘要。分别说明无匹配和权限错误。不要读取完整邮件、标为已读、更改标签、创建草稿或发送邮件。
让 AI 助手查找重要邮件、整理会话要点,并准备供你审阅的回复草稿。 选择 MCP 或 oo CLI + Skill 接入。
每月 20,000 次免费应用调用(付费服务另计)
开始使用 Gmail ↓通过 Google 账号授权连接 Gmail。
一个可以使用 Gmail 的 Google 账号。
登录 OOMOL,选择团队,在 Gmail 连接页使用支持的授权方式创建连接。确认连接处于活跃状态,然后在 MCP 配置或 oo CLI 登录中使用同一个团队。
连接 Gmail用 OOMOL 配置页中的密钥和团队名称替换占位符。请妥善保管凭证,并保留已有的其他服务配置。
在支持远程 Streamable HTTP MCP 和自定义请求头的客户端中,按下方参数添加远程 MCP 服务。完整密钥和团队信息从 OOMOL MCP 配置页获取;不同客户端的字段名称和配置格式可能不同。
将占位符替换为自己的值。Authorization 使用 Bearer 加 MCP 密钥,x-oo-team-name 使用应用连接所在的团队名称。优先使用客户端的保密输入或环境变量功能。只填写 URL 而缺少这些请求头,配置仍不完整。
打开用户目录下的 ~/.cursor/mcp.json。如果文件不存在,用从 OOMOL 复制的 JSON 创建文件;如果已有配置,将 oomol 条目合并到现有 mcpServers 对象中。保存后重新连接服务,并新建一个 Agent 对话。
{
"mcpServers": {
"oomol": {
"url": "https://connector.oomol.com/v1/mcp",
"headers": {
"Authorization": "Bearer <mcp-api-key>",
"x-oo-team-name": "<team-name>"
}
}
}
}
打开 ~/.codex/config.toml,添加或更新唯一的 oomol 配置,将 <team-name> 替换为复制配置中的团队名称。在启动 Codex 的进程环境中设置 OOMOL_MCP_API_KEY,值为 Authorization 中的密钥本身,不包含 Bearer 前缀。删除 oomol.http_headers 中旧的 Authorization 项,不要把密钥写入 config.toml。使用该环境重新启动 Codex。
[mcp_servers.oomol]
url = "https://connector.oomol.com/v1/mcp"
bearer_token_env_var = "OOMOL_MCP_API_KEY"
[mcp_servers.oomol.http_headers]
"x-oo-team-name" = "<team-name>"
在 macOS 或 Linux 上使用 Codex CLI 和 Bash 时,运行以下命令,在不回显的提示处粘贴密钥。密钥只传给本次 Codex 进程,不会写入文件或命令历史。桌面端或 IDE 客户端需要在各自的启动环境中获得同名变量;另一个终端中设置的变量不一定可用。
bash -c '
read -r -s -p "OOMOL MCP API key: " OOMOL_MCP_API_KEY || exit 1
export OOMOL_MCP_API_KEY
exec codex
'
在项目根目录创建或合并下方 .mcp.json 配置,替换 <team-name>。在启动 Claude Code 的环境中设置 OOMOL_MCP_API_KEY,值为不含 Bearer 的密钥。下方 Bash 示例可在 macOS/Linux 中隐藏输入密钥并启动 claude。按提示批准项目服务后,用 /mcp 检查状态。
{
"mcpServers": {
"oomol": {
"type": "http",
"url": "https://connector.oomol.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${OOMOL_MCP_API_KEY}",
"x-oo-team-name": "<team-name>"
}
}
}
}
bash -c '
read -r -s -p "OOMOL MCP API key: " OOMOL_MCP_API_KEY || exit 1
export OOMOL_MCP_API_KEY
exec claude
'
在 VS Code 中执行 MCP: Open User Configuration,将下方 servers 和 inputs 条目合并进去,保留已有配置。替换 <team-name> 并保存,再用 MCP: List Servers 启动 oomol。出现提示时输入不含 Bearer 的 MCP 密钥。保密输入可以避免将密钥写入此配置文件。
{
"inputs": [
{
"type": "promptString",
"id": "oomolMcpKey",
"description": "OOMOL MCP API key",
"password": true
}
],
"servers": {
"oomol": {
"type": "http",
"url": "https://connector.oomol.com/v1/mcp",
"headers": {
"Authorization": "Bearer ${input:oomolMcpKey}",
"x-oo-team-name": "<team-name>"
}
}
}
}
检查是否出现 connector_list_apps、connector_search_actions 等 OOMOL 工具。它们用于发现和执行 Gmail 操作,各操作不一定单独出现在 MCP 工具列表中。 常见问题 →
将此只读任务复制到新的 AI 对话中执行。查询失败时,请查看常见问题。
核对返回的资源标识是否与你的目标一致,并查看查询结果。
仅使用 OOMOL MCP。 检查当前配置的 OOMOL 团队中是否有活跃的 Gmail 连接。读取已连接邮箱的个人资料并报告邮箱地址。使用 newer_than:7d 搜索最近 7 天的邮件线程,最多返回 5 项。报告查询条件、线程 ID 和实际返回的摘要。分别说明无匹配和权限错误。不要读取完整邮件、标为已读、更改标签、创建草稿或发送邮件。
替换方括号中的参数后复制任务。部分任务会修改数据,执行前请确认目标和操作。
查找相关邮件,让 AI 提取决定、截止日期和待确认的问题。
仅使用 OOMOL MCP。 查找本周有关上线的邮件,总结已确定的事项和待确认的问题。
结合邮件内容和你的要求起草邮件,保存后再审阅。
仅使用 OOMOL MCP。 找到询问交付时间的邮件,按下周三交付起草回复,保存为草稿。
查找符合条件的邮件,并使用 Gmail 标签分类。
仅使用 OOMOL MCP。 找到本周的发票邮件,加上我已有的“发票”标签。
把要点整理成邮件,发送给指定收件人。
仅使用 OOMOL MCP。 给 [收件人] 发送邮件,主题为 [主题]:感谢对方参加会议,确认 [决定],并请对方在 [日期] 前完成 [下一步]。
Gmail 是 Google 提供的电子邮件服务。连接账号后,AI 助手可以在你授予的权限范围内使用支持的邮件操作。
按搜索条件查找邮件,读取邮件内容用于分析。
将邮件保存为 Gmail 草稿,便于发送前审阅。
列出可用标签,并为选定的邮件添加标签。
按查询搜索 Gmail 线程,并返回轻量级线程摘要。除非你在查询中明确指定,否则垃圾邮件和废纸篓会被排除在外。
gmail.search_threads列出 Gmail 线程,支持可选的查询筛选和分页。除非你在查询中明确指定,否则垃圾邮件和废纸篓会被排除在外。
gmail.list_threads列出 Gmail 消息,支持可选的查询、标签和分页过滤器。使用 `detail` 选择仅标识符、轻量摘要或完整规范化消息。
gmail.fetch_emails通过消息 ID 获取 Gmail 消息,输出为简化规范化格式。当您只需要主题、发件人、收件人、日期和正文时使用。
gmail.get_message通过消息 ID 获取 Gmail 消息,响应格式可控。当您需要规范化完整消息载荷而不是简化的 `get_message` 输出时使用。
gmail.fetch_message_by_message_id使用消息操作返回的元数据下载 Gmail 消息附件,并将其上传到 Connector 文件传输存储。
gmail.download_attachment获取 Gmail 会话中的所有消息。使用此操作检查已知 `threadId` 的完整对话载荷。
gmail.fetch_message_by_thread_id获取已连接的 Gmail 配置文件,包括邮箱总数和当前 `historyId`。使用返回的 `historyId` 作为通过 `list_history` 进行增量同步的检查点。
gmail.get_profile从已连接的 Gmail 账户发送电子邮件。至少需要一个收件人以及主题或正文之一。
gmail.send_email回复 Gmail 会话中的指定邮件,并保留原邮件的回复头;可通过 to 覆盖 Reply-To 或 From 指定的收件人。
gmail.reply_email回复现有的 Gmail 会话,同时保留 Gmail 的会话线程。当您希望回复保持在同一个对话中并可选地覆盖收件人时使用。
gmail.reply_to_thread使用简化字段创建 Gmail 草稿,返回稳定的草稿 ID 以及当前邮件和会话 ID。
gmail.create_draft创建 Gmail 草稿。通过 replyToMessageId 或 threadId 创建回复草稿时,需要邮箱读取权限;省略的主题和收件人继承自回复目标,显式主题须与目标匹配。
gmail.create_email_draft列出 Gmail 草稿并支持分页,当 `verbose` 为 true 时,可选地将每个草稿充实为完整的消息详情。
gmail.list_drafts通过草稿 ID 获取 Gmail 草稿。使用 `format` 参数控制返回多少消息详情。
gmail.get_draft更新 Gmail 草稿。通过 replyToMessageId 或不同的 threadId 重建回复关联时,需要邮箱读取权限。回复主题须与目标匹配;仅编辑邮件头时保留 MIME 正文。省略 attachments 时保留附件,传入列表时替换全部附件,传入空数组时清空附件。空字符串会清空对应字段。拒绝对不支持的 MIME 结构进行内容编辑。
gmail.update_draft使用草稿中已存储的收件人按原样发送现有的 Gmail 草稿。发送是即时的,此操作无法安排发送时间。
gmail.send_draft通过草稿 ID 永久删除 Gmail 草稿,而不是发送它。
gmail.delete_draft列出所有系统和用户创建的 Gmail 标签。使用此操作发现标签修改操作所需的内部标签 IDs。
gmail.list_labels获取 Gmail 标签的详细信息,包括名称、类型、可见性设置、计数和可选颜色。
gmail.get_label创建新的 Gmail 标签并返回其内部标签 ID。在后续的标签修改操作中使用返回的 ID。
gmail.create_label修补用户创建的 Gmail 标签。用于对标签名称、可见性设置或颜色进行部分更新。
gmail.patch_label更新现有 Gmail 标签的属性,包括名称、可见性设置或颜色。
gmail.update_label从邮箱中永久删除用户创建的 Gmail 标签。这会删除标签定义本身,而不仅仅是将其从一条消息中分离。
gmail.delete_label在单个 Gmail 消息上添加和/或移除标签。提供至少一个标签变更,并使用来自 `list_labels` 的标签 IDs。
gmail.add_label_to_email在一次请求中最多为 1,000 条 Gmail 消息添加和/或移除标签。用于批量归档、标记为已读或自定义标签工作流。
gmail.batch_modify_messages将 Gmail 消息移至废纸篓。消息在 Gmail 永久删除之前仍可恢复。
gmail.move_to_trash将之前丢弃的 Gmail 消息恢复到邮箱。
gmail.untrash_message在 Gmail 会话中的每条消息上添加和/或移除标签。当标签更改应应用于整个对话时使用。
gmail.modify_thread_labels将整个 Gmail 会话移至废纸篓,包括该对话中的所有消息。
gmail.move_thread_to_trash恢复之前丢弃的 Gmail 会话及其消息。
gmail.untrash_thread在已知 `startHistoryId` 之后列出 Gmail 邮箱更改历史。用于增量同步,并将最新的返回 `historyId` 作为检查点。
gmail.list_history列出邮箱的 Gmail 过滤器。用于审计现有规则或避免创建重复项。
gmail.list_filters通过过滤器 ID 获取 Gmail 过滤器,以便检查其条件和操作。
gmail.get_filter创建 Gmail 过滤器,包含匹配条件和结果操作。用于自动整理收到的邮件。
gmail.create_filter按过滤器 ID 永久删除 Gmail 过滤器。
gmail.delete_filter获取已连接账户的 Gmail 显示语言设置。
gmail.get_language_settings更新已连接账户的 Gmail 显示语言设置。
gmail.update_language_settings获取 Gmail 假期回复设置,包括是否启用自动回复及其当前内容。
gmail.get_vacation_settings更新 Gmail 假期回复设置。使用此操作可配置外出自动回复及其生效时间窗口。
gmail.update_vacation_settings获取当前 Gmail 自动转发配置,包括启用状态、转发地址和处理方式。
gmail.get_auto_forwarding列出已在 Gmail 账户上注册的转发地址。
gmail.list_forwarding_addresses获取 Gmail IMAP 设置,包括 IMAP 是否已启用以及清除或文件夹大小设置如何配置。
gmail.settings_get_imap更新 Gmail IMAP 设置,包括启用状态、自动清除行为、清除行为或最大文件夹大小。
gmail.update_imap_settings获取 Gmail POP 设置,包括访问窗口和邮件处理方式。
gmail.settings_get_pop更新 Gmail POP 设置,包括访问窗口和处理行为。
gmail.update_pop_settings停止邮箱的 Gmail 推送监视通知。使用此操作可禁用之前通过 watch 端点创建的通知。
gmail.stop_watch没有匹配的工具。
使用包含活跃应用连接的 OOMOL 团队。应用授权、MCP 密钥和资源访问权限需要分别检查。根据工具实际错误核对资源标识和查询范围,分别报告空结果与访问错误,并妥善保管密钥。 Gmail 先核对邮箱地址。搜索为空时检查日期范围和查询条件;默认排除垃圾邮件和回收站。读到个人资料不代表具备邮件搜索权限,搜索条件需要 gmail.metadata 之外的相应权限。保存草稿和发送邮件分别属于写入操作。
可以总结邮件会话、准备回复草稿,或为符合条件的邮件添加标签。说明发件人、主题或日期范围,便于找到需要处理的邮件。
可以。草稿和发送是不同的操作。请明确要求保存草稿,然后在 Gmail 中审阅。
这个集成通过 Google OAuth 授权连接,不需要 Gmail API Key。
可以,需要授权 Gmail 和 Notion 连接。说明要总结哪些邮件,以及在哪个父页面下创建摘要。