Gmail MCP 服务器

MCP（模型上下文协议）服务器为 Claude Desktop 等 MCP 客户端提供 Gmail 集成功能。

特征

• 查看 Gmail 收件箱中的最近电子邮件

• 使用 Gmail 的搜索语法搜索电子邮件

• 使用 Gmail API 进行安全 OAuth2 身份验证

Related MCP server: Gmail AutoAuth MCP Server

设置

1. Google Cloud 项目设置

1. 在https://console.cloud.google.com/上创建 Google Cloud 项目

2. 启用 Gmail API

3. 创建 OAuth 2.0 凭据：

   • 应用程序类型：桌面应用程序

   • 下载凭证为credentials.json

2.安装

# Create a conda environment
conda create -n mcp-gmail python=3.12
conda activate mcp-gmail

# Install the package
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"
      }
    }
  }
}

将/path/to/替换为你的实际路径。令牌文件将在你首次进行身份验证时自动创建。

4. 首次运行

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

可用资源

• gmail://inbox/recent - 返回您最近的 10 封电子邮件

可用工具

• search_emails

  • 描述：通过查询搜索 Gmail 电子邮件

  • 参数：

    • query （必需）：Gmail 搜索查询（使用 Gmail 的标准搜索语法）

    • max_results （可选）：返回的最大结果数（默认值：10）

搜索示例：

Could you show me any emails from sanrio in the last two days?

安全

此服务器需要使用 Gmail 进行 OAuth2 身份验证：

• 首次使用时，系统会提示您在浏览器中授权访问

• 凭证本地存储在指定的令牌文件中

• 您可以随时通过 Google 帐户设置撤销访问权限

• 仅请求对 Gmail 的读取权限（无写入权限）

环境变量

• GMAIL_CREDENTIALS_FILE （必需）：您的 Google OAuth 凭据文件的路径

• GMAIL_TOKEN_FILE （必需）：身份验证令牌的保存路径

为了测试，您可以直接运行服务器：

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

发展

服务器使用模型上下文协议来提供：

• 资源访问最近的电子邮件

• 电子邮件搜索工具支持

• 安全 OAuth2 身份验证流程

• 自动令牌刷新

日志记录

服务器将其操作的详细信息记录到 stderr，包括：

• 服务器启动信息

• 身份验证状态

• 资源和工具使用

• 任何错误或问题

贡献

欢迎提交 Pull 请求！请确保：

• 更新任何新功能的文档

• 添加适当的错误处理

• 使用新功能测试 OAuth 流程

• 遵循现有的代码风格