Gmail MCP Server

基本能力

产品定位

Gmail MCP Server 是一个集成Gmail功能的MCP服务器，旨在为MCP客户端提供Gmail邮件访问和搜索能力。

核心功能

• 查看Gmail收件箱中的最近邮件
• 使用Gmail搜索语法搜索邮件
• 通过OAuth2安全认证与Gmail API交互

适用场景

• 在MCP客户端中快速访问Gmail邮件
• 通过自然语言查询搜索特定邮件
• 安全地集成Gmail功能到第三方应用

工具列表

• search_emails
• 描述：使用查询搜索Gmail邮件
• 参数：
  • query（必需）：Gmail搜索查询（使用Gmail的标准搜索语法）
  • max_results（可选）：返回的最大结果数（默认：10）

常见问题解答

• 首次使用时需要在浏览器中授权应用
• 凭证存储在本地指定的令牌文件中
• 可以随时通过Google账户设置撤销访问权限
• 仅请求对Gmail的读取权限（无写入权限）

使用教程

使用依赖

1. 在https://console.cloud.google.com/创建Google Cloud项目
2. 启用Gmail API
3. 创建OAuth 2.0凭证：
4. 应用类型：桌面应用
5. 将凭证下载为credentials.json

安装教程

# 创建conda环境
conda create -n mcp-gmail python=3.12
conda activate mcp-gmail

# 安装包
cd gmail-mcp-server
pip install -e .

调试方式

GMAIL_CREDENTIALS_FILE="/path/to/credentials.json" \
GMAIL_TOKEN_FILE="/path/to/token.json" \
python -m gmail_mcp_server.server

配置Claude Desktop

添加到claude_desktop_config.json：

{
  "mcpServers": {
    "gmail": {
      "command": "/path/to/conda/envs/mcp-gmail/bin/python",
      "args": ["-m", "gmail_mcp_server.server"],
      "env": {
        "PYTHONPATH": "/path/to/gmail-mcp-server/src",
        "GMAIL_CREDENTIALS_FILE": "/path/to/credentials.json",
        "GMAIL_TOKEN_FILE": "/path/to/token.json"
      }
    }
  }
}

替换/path/to/为实际路径。首次认证时会自动创建令牌文件。

首次运行

首次通过Claude访问Gmail时，系统会提示您在浏览器中授权应用。授权后，您的凭证将保存到令牌文件中以供将来使用。

许可证

None