Gmail MCP 服务器集成

“Gmail” MCP 服务器的作用是什么？

Gmail MCP 服务器是一款模型上下文协议（MCP）服务器，旨在将 Gmail 功能集成到诸如 Claude Desktop 等 AI 平台中。它的主要作用是作为 AI 助手与 Gmail 之间的桥梁，实现对邮件的自然语言管理，包括发送和读取邮件、管理标签、处理附件、搜索特定消息以及执行批量操作。通过将这些能力以 MCP 工具和资源的形式暴露，Gmail MCP 服务器使开发者能够创建强大的工作流，让 AI 代理自动化并简化邮件管理，便于从收件箱上下文检索数据，并以编程方式操作 Gmail 内容，同时通过安全的 OAuth2 认证保障安全。

提示词列表

仓库或文档中未列出明确的提示词模板。

资源列表

• 邮件消息
  将邮件消息作为资源暴露，可供 LLM 交互读取和使用上下文。

• Gmail 标签
  提供对系统和自定义 Gmail 标签的访问，可用于组织或检索邮件。

• 附件元数据
  支持检索邮件附件的信息，如文件名、类型和大小。

• 搜索结果
  允许客户端访问基于主题、发件人或日期范围的高级邮件搜索结果。

工具列表

基于文档所列功能，Gmail MCP 服务器提供以下工具：

• send_email
  发送包含主题、内容、附件和收件人的邮件，支持 HTML 和国际字符。

• read_email
  根据 ID 检索邮件消息，支持复杂的 MIME 结构。

• list_labels
  列出所有可用的 Gmail 标签（系统与自定义）。

• manage_labels
  创建、更新、删除和列出标签，实现全面的标签管理。

• search_emails
  使用多种条件（主题、发件人、日期范围）搜索邮件。

• list_emails_by_label
  列出收件箱、已发送或自定义标签下的邮件。

• mark_read_unread
  标记邮件为已读或未读。

• move_email
  将邮件移动到不同的标签/文件夹。

• delete_email
  从邮箱中删除邮件。

• batch_operations
  通过批量操作高效处理多封邮件。

该 MCP 服务器的应用场景

• 自动发送邮件
  开发者可设置工作流，让 AI 代理自动撰写并发送邮件，减少日常沟通的重复劳动。

• 收件箱分拣与管理
  AI 助手可将邮件分类、打标签并移动到合适的文件夹，帮助用户保持收件箱井然有序，优先处理重要信息。

• 邮件搜索与检索
  利用高级搜索条件，用户可快速定位特定邮件或附件，加快 Gmail 信息检索。

• 批量处理
  支持自动批量删除、标记已读/未读或移动大量邮件，适合邮件量大的用户节省时间。

• 标签管理自动化
  AI 可动态创建、更新或删除 Gmail 标签，结合用户需求或项目变化，提升邮件组织效率。

如何配置

Windsurf

1. 确保已安装 Node.js 等先决条件。
2. 打开 Windsurf 配置文件（通常为 windsurf.json 或类似文件）。
3. 添加 Gmail MCP 服务器包：

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

4. 保存配置并重启 Windsurf。
5. 通过 Windsurf 控制台确认 MCP 服务器已列出。

API 密钥安全示例：

{
  "mcpServers": {
    "gmail-mcp": {
      "command": "npx",
      "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Claude

1. 确保已设置好 Node.js 和 Claude 平台。
2. 编辑 Claude MCP 配置文件。
3. 添加 Gmail MCP 服务器：

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

4. 保存配置并重启 Claude。
5. 在 Claude 中确认服务器已激活。

环境变量示例：

{
  "env": {
    "GOOGLE_CLIENT_ID": "your-client-id",
    "GOOGLE_CLIENT_SECRET": "your-client-secret"
  }
}

Cursor

1. 安装 Node.js 并确保 Cursor 正在运行。
2. 在 Cursor 配置中添加 Gmail MCP 服务器：

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

3. 重启 Cursor 使配置生效。
4. 通过 MCP 服务器列表确认集成成功。

Cline

1. 确保环境已安装 Node.js。
2. 在 Cline 配置中添加 Gmail MCP 服务器项：

   {
     "mcpServers": {
       "gmail-mcp": {
         "command": "npx",
         "args": ["@gongrzhe/server-gmail-autoauth-mcp@latest"]
       }
     }
   }
   

3. 保存并重启 Cline。
4. 在界面中检查 Gmail MCP 服务器是否被识别。

注意：
请始终将敏感 API 密钥或凭证作为环境变量存储，切勿直接写入配置文件。使用 MCP 服务器配置中的 env 属性安全注入凭证。

如何在流程中使用 MCP

在 FlowHunt 中使用 MCP

要在 FlowHunt 工作流中集成 MCP 服务器，先在流程中添加 MCP 组件并连接到您的 AI 代理：

点击 MCP 组件，打开配置面板。在系统 MCP 配置区域，按照如下 JSON 格式填写您的 MCP 服务器信息：

{
  "gmail-mcp": {
    "transport": "streamable_http",
    "url": "https://yourmcpserver.example/pathtothemcp/url"
  }
}

配置完成后，AI 代理即可将此 MCP 作为工具，获得其所有功能。请记得将 “gmail-mcp” 替换为您实际的 MCP 服务器名称，并将 URL 替换为您自己的 MCP 服务器地址。

概览

根据现有文档，Gmail MCP 服务器在 Gmail 工作流自动化和集成方面功能完善，但缺少明确的提示词模板及采样/根支持文档。其安全处理与工具/资源暴露较为完善，整体我会给这款 MCP 打 7.5 分（满分 10 分），适合开发者集成使用。

MCP 评分