Gmail MCP Server

概述

Gmail MCP 服务器允许 Claude 桌面版等 MCP 客户端访问您的 Gmail 邮件，提供邮件查看和搜索功能。

设置步骤

1. Google Cloud 配置

1. 在 Google Cloud Console 创建项目
2. 启用 Gmail API
3. 创建 OAuth 2.0 凭据（桌面应用类型）
4. 下载凭据为 credentials.json

2. 服务器安装

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

# 安装服务器
cd gmail-mcp-server
pip install -e .

3. Claude 桌面版配置

编辑 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"
      }
    }
  }
}

4. 首次使用

首次访问 Gmail 时，系统会在浏览器中提示您授权。授权后，令牌将保存到指定的令牌文件中。

使用方法

查看最近邮件

访问资源: gmail://inbox/recent

搜索邮件

使用工具: search_emails 参数:

• query: Gmail 搜索语句
• max_results: 返回结果数量(默认10)

示例:

能否显示过去两天内来自 sanrio 的所有邮件？

安全说明

• 使用 OAuth2 认证
• 凭据本地存储
• 仅请求读取权限
• 可随时通过 Google 账户撤销访问

直接运行测试

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