Gmail MCP

基本能力

产品定位

Gmail MCP是一个为Gmail API提供标准化接口的服务，专注于电子邮件管理和自动化操作。

核心功能

• 完整的Gmail API覆盖，包括消息、线程、标签、草稿和设置管理
• 支持电子邮件的发送、草拟和管理
• 标签管理，包括自定义颜色和可见性设置
• 线程操作，用于对话管理
• 设置管理，包括假期自动回复、IMAP/POP和语言设置
• 邮箱变更的历史跟踪
• 使用Google Cloud凭证的安全OAuth2认证

适用场景

• 自动化电子邮件处理
• 批量邮件管理
• 邮件系统集成
• 邮件监控和通知

工具列表

• npx @shinzolabs/gmail-mcp: 通过NPX运行Gmail MCP
• smithery/cli: 通过Smithery自动安装

常见问题解答

1. 认证问题: 必须选择"Desktop app"作为应用类型，否则服务器无法解析JSON文件中的密钥。
2. 文件位置: 默认情况下，凭证文件应保存在~/.gmail-mcp/gcp-oauth.keys.json。
3. 环境变量: 可以使用GMAIL_OAUTH_PATH和GMAIL_CREDENTIALS_PATH自定义凭证文件位置。

使用教程

使用依赖

1. 访问Google Cloud Console
2. 创建或选择现有项目
3. 为项目启用Gmail API
4. 创建OAuth 2.0客户端ID（选择"Desktop app"类型）
5. 下载客户端凭证JSON文件

安装教程

NPX（推荐）

在claude_desktop_config.json中添加:

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

手动下载

1. 克隆仓库:

git clone https://github.com/shinzo-labs/gmail-mcp.git

1. 安装依赖并构建:

pnpm i && pnpm run build

1. 在claude_desktop_config.json中添加:

{
  "mcpServers": {
    "gmail": {
      "command": "node",
      "args": [
        "/path/to/gmail-mcp/dist/index.js"
      ]
    }
  }
}

Smithery安装

npx -y @smithery/cli install @shinzo-labs/gmail-mcp --client claude

调试方式

1. 运行认证命令:

npx @shinzolabs/gmail-mcp auth

或

pnpm i && pnpm run build && pnpm run auth

1. 浏览器将自动打开Google OAuth同意屏幕
2. 授权后关闭浏览器窗口
3. 令牌将自动保存到~/.gmail-mcp/credentials.json

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。