🚀 Gmail MCP 配置指南
本指南旨在帮助你配置 Gmail MCP，允许 Claude 从你的 Gmail 账户中搜索并检索邮件，为你提供更便捷的邮件管理体验。
🚀 快速开始
按照以下步骤完成 Gmail MCP 的配置：
- 获取 Google API 凭证
- 授权应用程序
- 在 Claude 中配置
- 环境变量配置
✨ 主要特性
- 搜索邮件：在你的 Gmail 账户中搜索邮件。
- 获取邮件内容：检索特定邮件的完整内容。
- 列出消息：列出你 Gmail 收件箱中的最近邮件。
📦 安装指南
获取 Google API 凭证
- 访问 Google Cloud Console
- 创建新项目或选择现有项目
- 启用项目的 Gmail API：
- 进入 "APIs & Services" > "Library"
- 搜索 "Gmail API" 并启用它
- 创建 OAuth 凭证：
- 前往 "APIs & Services" > "Credentials"
- 点击 "创建凭证" > "OAuth 客户端 ID"
- 选择应用类型为 "桌面应用"
- 输入名称并点击 "创建"
- 下载凭证 JSON 文件
- 将其保存为
credentials.json放置在你的项目目录中
授权应用程序
运行授权命令以生成令牌：
uv run gmail-mcp auth --creds-path credentials.json --token-path token.json
这将打开浏览器窗口，你需要登录 Google 账户并授予必要的权限。授权完成后，会在项目目录中创建 token.json 文件。
💻 使用示例
在 Claude 中配置
将 Gmail MCP 服务器添加到你的 Claude 配置文件：
{
"mcpServers": {
"gmail": {
"args": [
"--from",
"git+https://github.com/vinayak-mehta/gmail-mcp",
"gmail-mcp"
],
"command": "/Users/username/.local/bin/uvx",
"env": {
"GMAIL_CREDS_PATH": "/Users/username/path/to/gmail-mcp/credentials.json",
"GMAIL_TOKEN_PATH": "/Users/username/path/to/gmail-mcp/token.json"
}
}
}
}
请确保：
- 将
/Users/username/path/to/gmail-mcp替换为你的实际项目路径 - 调整
command路径以匹配你安装的uvx可执行文件 - 提供正确的凭证和令牌文件路径
工具使用示例
搜索邮件
在你的 Gmail 账户中搜索邮件。 示例提示："查找所有来自 example@gmail.com 的邮件"
获取邮件内容
检索特定邮件的完整内容。 示例提示："显示主题为 '明天开会' 的邮件全文"
列出消息
列出你 Gmail 收件箱中的最近邮件。 示例提示："列出我最 recent 的 5 封邮件"
🔧 技术细节
你可以通过环境变量来配置凭证和令牌文件的路径：
GMAIL_CREDS_PATH：凭证 JSON 文件的路径GMAIL_TOKEN_PATH：令牌 JSON 文件的路径
在项目根目录中创建一个 .env 文件，添加这些变量以实现便捷配置。