Gmail MCP - Instalación Automática y Segura

Gmail MCP - 自动安全安装

通过 Model Context Protocol（MCP）让 AI 助手访问 Gmail

基本要求： 必须安装 Claude Desktop 才能使用此 MCP 服务。

🧪 什么是 MCP？

MCP（Model Context Protocol）是由 Antrophic 开发的一种集成协议，旨在促进语言模型（如 ChatGPT 或 Claude）与外部工具（API、数据库、Web 服务等）之间的通信。其目标是为模型提供更丰富、结构化且实时的上下文，使其能够执行文本之外的操作。

---

🎥 使用示例视频

https://github.com/user-attachments/assets/e49b2d76-bcef-4d44-9222-6818f0f57998

🚀 快速安装（Windows）

1. 首先：
   • 前往 Google Cloud Console
   • 创建项目并启用 Gmail API
   • 将 http://localhost:8080/ 添加到授权重定向 URI
   • 下载 client_secret_...json 文件，并将其放在“下载”文件夹中（不用担心文件名或最终位置）
   • 安装程序会自动检测该文件，并将其移至正确的文件夹并使用合适的文件名

重要

只需在 Google Cloud 中配置授权重定向 URI后下载凭据文件，并将其放在“下载”文件夹中即可。不用担心文件名或最终位置，安装程序会处理一切！

2. 在终端中克隆此仓库：

   git clone https://github.com/FranciscoYuster/claude-client-gmail-mcp
   cd claude-client-gmail-mcp
   

3. 然后运行脚本：

   python setup.py
   

4. 安装程序会完成剩下的工作
5. 看到最终消息后，打开 Claude Desktop，即可开始使用！

---

💻 在 macOS / Linux 上安装

1. 按照上文所述的 Google Cloud 步骤获取凭据文件，并将其放在“下载”文件夹中。
2. 在终端中克隆此仓库：

   git clone https://github.com/FranciscoYuster/gmail-client-mcp-server
   cd gmail-client-mcp-server
   

3. 运行适用于 Unix 系统的脚本：

   python3 setupUnix.py
   

4. 安装程序会完成剩下的工作。
5. 看到最终消息后，打开 Claude Desktop，即可开始使用！

---

重要

如果使用 Windows，请运行：python setup.py 如果使用 macOS 或 Linux，请运行：python3 setupUnix.py 两个脚本都会执行安装，但各自针对相应的操作系统进行了适配。

---

🔒 安全

警告

切勿上传或分享凭据文件。 如果不慎泄露，请将其删除，并在 Google Cloud Console 中重新生成。脚本绝不会上传或分发你的敏感数据。

---

📝 前置要求

• Python 3.11 或更高版本
• git
• Gmail 账号
• Claude Dekstop

提示

安装程序会指导你安装任何缺少的前置要求。

---

⚙️ 手动配置

🚀 配置

1. 克隆此仓库：

   git clone https://github.com/FranciscoYuster/claude-client-gmail-mcp
   cd claude-client-gmail-mcp
   

2. 创建并激活虚拟环境：

   uv init
   # o alternativamente
   uv venv
   

   然后激活它：

   .venv\scripts\activate
   

3. 安装依赖：

   uv pip install -r requirements.txt
   

4. 配置 OAuth 凭据：
   • 在项目根目录中创建名为 credentials 的目录
   • 在 Google Cloud Console 中创建项目
   • 启用 Gmail API
   • 创建 OAuth 凭据
   • 将以下 URI 添加到授权重定向 URI：

     http://localhost:8080/
     

   • 下载凭据 JSON 文件，并将其保存为 credentials/client_secret_gmail_oauth.json

注意

请确保凭据文件的路径和名称正确，以避免身份验证错误。

5. 将 MCP 服务添加到 JSON 配置中。请查阅 MCP 客户端的官方文档，了解具体说明。请务必根据你的环境调整路径：

   {
       "mcpServers": {
           "gmail-mcp": {
               "command": "uv",
               "args": [
                   "--directory",
                   "/path/to/your/gmail-mcp/src",
                   "run",
                   "main.py"
               ]
           }
       }
   }
   

6. 运行 Claude Desktop

---

可用工具

该服务包含一系列工具，可通过 AI 助手操作和自动化 Gmail。这些工具可用于发送、读取、搜索和管理邮件及标签。以下列出了主要可用功能：

邮件操作

• 发送邮件（支持附件、抄送、密送、回复邮件会话）
• 创建邮件草稿（支持附件）
• 下载邮件附件
• 按 ID 读取邮件（纯文本和 HTML，支持对较大邮件进行分块）
• 使用高级筛选条件搜索邮件（查询、标签、发件人、附件、分页）
• 获取完整的邮件会话
• 将邮件标记为已读／未读／重要／不重要

标签管理

• 为邮件添加或移除标签
• 创建新标签
• 按名称删除标签
• 列出所有标签
• 按名称获取或创建标签
• 更新标签设置（名称、可见性、颜色）
• 按名称搜索标签

这些工具支持对 Gmail 邮件和标签进行高级自动化管理，便于与 AI 助手和工作流集成。

📝 许可证

MIT。请参阅 LICENSE 文件。