local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows viewing recent emails from Gmail inbox and searching emails using Gmail's search syntax through OAuth2 authentication with the Gmail API.

Gmail MCP 服务器

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

特征

查看 Gmail 收件箱中的最近电子邮件
使用 Gmail 的搜索语法搜索电子邮件
使用 Gmail API 进行安全 OAuth2 身份验证

设置

1. Google Cloud 项目设置

在https://console.cloud.google.com/上创建 Google Cloud 项目
启用 Gmail API
创建 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 流程
遵循现有的代码风格

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

一个集成服务器，为 Claude Desktop 提供对 Gmail 的访问，使用户能够使用自然语言命令查看最近的电子邮件并搜索他们的 Gmail 收件箱。

Related Resources

Reddit Discussion about this server

Gmail MCP Server