SuperAPI AI 工具集
合作ENAI 行业资讯收藏
全部工具AI开发平台mcp-google-gmail

mcp-google-gmail

A1 Gmail MCP 是一个基于 Gmail API 的 MCP 服务器，让 AI 应用（如 Claude、Cursor、Codex 等）用自然语言操作 Gmail 邮箱。它提供 24 个工具，支持搜索和阅读邮件与会话、直接发送或通过草稿发送邮件、管理草稿生命周期、标签和垃圾箱。服务器通过 OAuth 2.0 连接，可在对话中完成授权，无需配置文件。发送操作被标记为破坏性，且不会在不确定失败后重发；删除邮件通过可逆的垃圾箱进行，不提供永久删除工具。读取内容有截断限制，附件仅返回元数据。使用 gmail.modify 最小权限范围。

访问官网

工具介绍

A1 Gmail MCP 是一个 MCP（Model Context Protocol）服务器，用于连接 Gmail API，让 AI 应用能够用自然语言操作 Gmail 邮箱。它面向 Claude、Cursor、Codex 等支持 MCP 的 AI 客户端。

用途

该服务器让 AI 助手可以搜索和阅读邮件、准备回复草稿、在准备好时发送、整理标签，并使用垃圾箱代替永久删除。它使用你的 Google 账户通过 Gmail API 工作，并明确区分可编辑的草稿和不可撤回的已发送邮件，同时明确 Gmail API 的限制，而不是暗示所有邮件任务都可逆。

主要能力

  • 提供 24 个工具，覆盖搜索和阅读邮件与会话、直接发送或通过草稿发送邮件、管理草稿生命周期、标签和垃圾箱。
  • 从对话中连接：说“connect Gmail”，服务器会引导你完成 OAuth 客户端设置，在 127.0.0.1 上通过 PKCE 捕获 Google 重定向，并自行保存令牌——无需配置文件，无需重启。
  • 谨慎发送：草稿 → 审核 → 发送路径是一等公民；发送被标记为破坏性，服务器在不确定失败后不会重发——邮件无法撤回。
  • 垃圾箱作为安全网：删除邮件通过可逆的垃圾箱（约 30 天）；故意不提供永久删除邮件的工具。
  • 有界阅读：解码后的正文在显式限制处截断，附件以元数据形式返回，因此长邮件不会无声地淹没对话。
  • 最小 Google 权限范围：仅使用 gmail.modify——不进行永久删除，也不访问 Gmail 设置。

使用方式

需要 Node.js 20+ 和一个 Google 账户。安装时不需要凭据——服务器从对话中连接。

将服务器添加到你的 AI 应用：

  • 在应用中：打开 Settings → MCP servers，选择 Add server，选择 STDIO，输入命令 npx -y mcp-google-gmail@latest 和环境变量 GOOGLE_GMAIL_CLIENT_ID、GOOGLE_GMAIL_CLIENT_SECRET、GOOGLE_GMAIL_REFRESH_TOKEN，然后选择 Save and Restart。
  • 从命令行：参考 Codex MCP 文档和 Claude Code MCP 文档。
  • Claude Desktop：当前官方路径是 Settings → Extensions。对于自定义桌面扩展，打开 Advanced settings → Extension Developer → Install Extension…，选择 .mcpb 文件并按照提示操作。该仓库目前发布 npm stdio 包，不包含 .mcpb 捆绑包。对于仍支持本地配置的 Claude Desktop 构建，可使用 JSON stdio 配置作为回退，保存到 macOS 的 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 的 %APPDATA%\Claude\claude_desktop_config.json。
  • Cursor：添加到 macOS/Linux 的 ~/.cursor/mcp.json 或 Windows 的 %USERPROFILE%.cursor\mcp.json。
  • VS Code：运行 MCP: Open User Configuration 并添加配置，用 MCP: List Servers 检查。

连接方式：

  • 从聊天连接（推荐）：说“connect Gmail”，助手会运行流程：setup_instructions 打印检查清单；下载 OAuth 客户端 JSON 并给助手路径，set_client 以仅所有者权限存储；start_login 返回 Google 同意链接，在本地机器打开并批准，代码返回到 127.0.0.1 的一次性监听器（PKCE）；finish_login 交换代码并将令牌保存到 ~/.config/mcp-google-gmail/credentials.json（模式 0600），并用真实 Gmail API 调用验证。令牌在每次调用时重新读取，因此连接立即生效，无需重启 AI 应用。auth_status 显示连接状态，logout 撤销并删除。
  • 环境变量（CI、无人值守安装）：创建或选择 Google Cloud 项目并启用 Gmail API；配置 OAuth 同意屏幕并创建桌面应用 OAuth 客户端；授权要连接的 Google 账户；请求范围 https://www.googleapis.com/auth/gmail.modify。测试模式 OAuth 刷新令牌可能在七天后过期，需要长期访问时发布 OAuth 应用或在 Workspace 域中使用内部应用。每个变量都是可选的——没有它们时服务器从聊天连接。

适用场景

  • 分类收件箱：显示过去七天的未读邮件并按发件人分组；查找与 Acme 关于合同的对话并总结；查看有附件的邮件。
  • 撰写和发送邮件：在会话中起草回复；显示草稿、润色措辞然后发送；发送简短状态邮件并抄送经理。
  • 整理邮箱：创建标签并应用；将本周新闻邮件标记为已读并归档；将会话移到垃圾箱，改变主意时恢复。

限制

  • 已发送邮件在外部不可逆。超时或 5xx 错误后服务器不会重发；重试前先搜索 in:sent，因为重放发送会导致重复发送。
  • 删除邮件或会话意味着放入垃圾箱。manage_trash 可逆约 30 天；故意没有永久删除工具。
  • 草稿是例外：update_draft 替换整个草稿（API 没有部分编辑），delete_draft 是永久的，因为草稿跳过垃圾箱。
  • 每次调用只作用于一个邮箱——授予令牌的账户。解码正文在可配置限制处截断并带有显式标志，附件仅返回元数据；附件内容需通过 raw_request 有意获取。
  • AI 客户端控制确认提示。服务器标记读取、写入和破坏性工具，以便客户端区分检查和实际更改。
  • Google Gmail 需要 OAuth 2.0；API 密钥不够。
  • 配额：Gmail 允许每用户每秒约 250 配额单位；发送消耗 100 单位，典型读取 5 单位。消费者账户每天可发送约 500 封邮件，Workspace 账户约 2,000 封。遇到 429 时服务器使用退避；读取也会在网络和 5xx 错误后重试，而发送和其他写入在不确定失败后从不重放。
  • 没有后台轮询。服务器仅在调用时运行。如果 AI 应用支持计划任务，可以定期检查收件箱；raw_request 也可以访问 history.list 进行增量同步。
  • 匿名遥测包含安装 ID、包版本、AI 客户端和平台版本以及工具名称——绝不包含 OAuth 令牌、邮件内容、工具参数或提示。设置 ASKADS_TELEMETRY=0 可退出。

同类工具

查看分类