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. 创建 Google Cloud 项目：https://console.cloud.google.com/
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 访问 Gmail 时，系统会提示您在浏览器中授权应用。授权后，您的凭证将保存到令牌文件中以供将来使用。

许可证

None