无头 Gmail MCP 服务器

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

无头 Gmail MCP 服务器是一种模型上下文协议（MCP）服务器，实现与 Gmail 账户的无缝交互，可用于发送和获取邮件，无需本地凭据或令牌配置。专为无头和远程操作设计，允许客户端独立完成 OAuth 流程，并以上下文安全传递凭据，使其能够在完全容器化或云环境中运行，无需本地文件访问或浏览器交互。该服务器非常适合需要专注、可靠 Gmail 访问的工作流——如营销自动化或通知系统——通过 MCP 接口暴露标准化工具，便于邮件管理及集成进 AI 开发流水线。

提示词列表

仓库中未提及具体的提示词模板。

资源列表

可用文档或代码中未描述明确的 MCP 资源。

工具列表

• 获取最近邮件
  从 Gmail 账户获取最新邮件，返回邮件正文前 1,000 个字符。
• 获取完整邮件正文
  通过 offset 参数分块获取邮件完整内容，每次 1,000 字符，支持大邮件读取。
• 发送邮件
  通过已连接的 Gmail 账户发送邮件。
• 刷新访问令牌
  独立处理令牌刷新，确保持续安全访问。

本 MCP 服务器的应用场景

• 自动化邮件通知
  与 AI 智能体或自动化平台集成，实现实时邮件告警或通知，无需人工干预。
• Gmail 收件箱监控
  获取并处理最新邮件，实现自动回复、分类或信息抽取，支持下游工作流。
• 营销活动自动化
  编程方式发送个性化营销邮件，利用 MCP 实现可扩展、凭据分离的运营。
• 无缝 API 集成
  将 Gmail 操作嵌入开发环境或其他支持 MCP 的平台，无需暴露或管理本地凭据。
• 远程/云端邮件管理
  在 Docker 化或远程环境中管理 Gmail 账户，实现安全、无头运行，无需本地依赖。

如何安装和配置

Windsurf

1. 确保已安装 Node.js 与 Windsurf。
2. 打开配置文件（如 windsurf.json）。
3. 在 mcpServers 区块添加无头 Gmail MCP 服务器：

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. 保存并重启 Windsurf。
5. 在 Windsurf 仪表盘验证服务器运行状态。

API 密钥安全配置
使用环境变量安全传递凭据：

{
  "mcpServers": {
    "headless-gmail": {
      "command": "npx",
      "args": ["@baryhuang/mcp-headless-gmail@latest"],
      "env": {
        "GMAIL_CLIENT_ID": "...",
        "GMAIL_CLIENT_SECRET": "...",
        "GMAIL_ACCESS_TOKEN": "...",
        "GMAIL_REFRESH_TOKEN": "..."
      }
    }
  }
}

Claude

1. 安装 Claude 并确保 Node.js 可用。
2. 编辑配置文件（如 claude.json）。
3. 添加服务器：

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. 保存并重启 Claude。
5. 在 Claude 界面内检查服务器状态。

API 密钥安全配置
如上所述，通过 env 键安全注入凭据。

Cursor

1. 确认已安装并更新 Cursor。
2. 打开 Cursor 的设置或配置文件。
3. 插入 MCP 服务器条目：

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. 保存并重启 Cursor。
5. 确认 MCP 服务器已被识别。

API 密钥安全配置
通过前述 env 区块配置凭据。

Cline

1. 安装 Cline 及其依赖。
2. 打开 Cline 配置文件。
3. 添加 MCP 服务器：

   {
     "mcpServers": {
       "headless-gmail": {
         "command": "npx",
         "args": ["@baryhuang/mcp-headless-gmail@latest"]
       }
     }
   }
   

4. 保存并重启 Cline。
5. 通过 Cline 工具确保服务器已连通。

API 密钥安全配置
如前例，通过环境变量方式传递 API 凭据。

如何在流程中使用本 MCP

在 FlowHunt 中集成 MCP

要将 MCP 服务器集成进 FlowHunt 工作流，首先在流程中添加 MCP 组件，并连接到你的 AI 智能体：

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

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

配置完成后，AI 智能体即可作为工具使用该 MCP，获得全部功能与能力。请将 “headless-gmail” 替换为你实际的 MCP 服务器名称（如 “github-mcp”、“weather-api” 等），并将 URL 替换为你的 MCP 服务器地址。

概览

我们的观点

根据现有信息，无头 Gmail MCP 服务器聚焦明确，易于集成，为大多数平台和 Docker/无头环境提供了清晰的使用说明。不过，其缺少明确的提示词模板和资源定义，可能对部分高级 MCP 应用有限制。其优势在于简洁、安全和在邮件自动化场景中的实用价值。总体来说，实用可靠但功能完整度略逊于部分其他 MCP 服务器。

MCP 评分