Gmail MCP Server 配置与使用说明

支持客户端

• Claude Desktop
• Cursor

安装命令

npx -y @modelcontextprotocol/server-gmail

配置示例

{
  "mcpServers": {
    "gmail": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gmail"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<your-client-id>",
        "GOOGLE_CLIENT_SECRET": "<your-client-secret>"
      }
    }
  }
}

需要设置环境变量：GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET。不要把这些值提交到公开仓库。

权限范围与安全提示

可读取和发送邮件，风险较高，建议仅授权只读权限进行测试

• network-access
• credential-required
• message-send

风险评分：7/10

常见报错

OAuth 认证失败

确认 Google Cloud 项目已启用 Gmail API

发送失败

确认 OAuth scope 包含 gmail.send 权限

来源

• 官方文档 / 仓库

最近核验：2026-05-18。客户端版本和配置格式可能变化，使用前请以官方文档为准。

相关工具