Gmail MCP

Gmail MCP

使用 Model Context Protocol 为 AI 助手提供 Gmail API
English | Español | 日本語

---

📋 英文文档

欢迎向此仓库提交拉取请求。

📖 目录

• 概述
• 功能
• 前提条件
• 设置
• 使用方法
• 许可证

🔍 概述

Gmail MCP 是一款服务实现，可让 AI 助手通过 MCP（Model Context Protocol）与 Gmail 交互。它提供用于发送邮件、管理草稿、阅读邮件、搜索收件箱、管理 Gmail 标签和管理过滤器的工具。

✨ 功能

• ✉️ 发送邮件和创建草稿
• 📬 阅读和搜索邮件
• 🗑️ 删除邮件
• 🏷️ 管理 Gmail 标签（创建、更新、删除）
• 🗂️ 管理 Gmail 过滤器（创建、更新、删除）
• 🔐 使用 Gmail API 进行 OAuth2.0 身份验证

📋 前提条件

• Python 3.11 或更高版本
• Gmail 账号
• 已启用 Gmail API 的 Google Cloud Platform 项目
• uv - Python 包安装程序

🚀 设置

1. 克隆此仓库

git clone https://github.com/ykuchiki/gmail-mcp.git
cd gmail-mcp

2. 创建并激活虚拟环境

uv init

3. 安装依赖项

uv pip install -r requirements.txt

4. 设置 OAuth 凭据

   • 在项目根目录中创建名为 credentials 的目录
   • 在 Google Cloud Console 中创建项目
   • 启用 Gmail API
   • 创建 OAuth 凭据
   • 将以下 URI 添加到 Authorized redirect URIs：

     http://localhost:8080/
     

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

5. 添加 MCP 服务 请参阅 MCP 客户端的官方文档，了解具体说明。请务必根据你的环境调整路径。

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

6. 运行服务

uv run main.py

💡 使用方法

此服务可与任何兼容 MCP 的客户端搭配使用。首次运行时，系统会提示你使用 Gmail 账号进行身份验证。

📄 许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

---

📋 日文文档

欢迎向本仓库提交拉取请求。

📖 目录

• 概述
• 功能
• 前提条件
• 设置
• 使用方法
• 许可证

🔍 概述

Gmail MCP 是一款服务实现，可让 AI 助手通过 MCP（Model Context Protocol）使用 Gmail。它提供发送邮件、管理草稿、阅读邮件、搜索收件箱、管理 Gmail 标签和管理过滤器等工具。

✨ 功能

• ✉️ 发送邮件和创建草稿
• 📬 阅读和搜索邮件
• 🗑️ 删除邮件
• 🏷️ 管理 Gmail 标签（创建、更新、删除）
• 🗂️ 管理过滤器（创建、更新、删除）
• 🔐 与 Gmail API 进行 OAuth2.0 身份验证 - 📎 发送邮件附件和创建带附件的草稿（支持多个附件，使用本地文件路径）

📋 前提条件

• Python 3.11 及以上版本
• Gmail 账号
• 已启用 Gmail API 的 Google Cloud Platform 项目
• uv - Python 包安装程序

🚀 设置

1. 克隆仓库

git clone https://github.com/ykuchiki/gmail-mcp.git
cd gmail-mcp

2. 创建并启用虚拟环境

uv init

3. 安装依赖

uv pip install -r requirements.txt

4. 配置 OAuth 凭据

   • 首先，在项目根目录下创建 credentials 目录
   • 在 Google Cloud Console 中创建项目
   • 启用 Gmail API
   • 创建 OAuth 凭据
   • 在已获授权的重定向 URI中添加以下内容：

     http://localhost:8080/
     

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

5. 添加 MCP 服务 添加方法请参阅所用 MCP 客户端的官方文档。 此外，请根据你的环境修改路径。

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

6. 运行服务

uv run main.py

💡 使用方法

此服务可与兼容 MCP 的客户端配合使用。首次运行时，系统会提示你使用 Gmail 账号进行身份验证。

添加附件发送 / 创建草稿

使用 attachments 参数指定本地文件路径（可指定多个，建议使用绝对路径）。

示例：发送

{
  "to": ["[email protected]"],
  "subject": "レポート送付の件",
  "body": "ご確認ください。",
  "attachments": [
    "/Users/you/Documents/report.pdf",
    "/Users/you/Pictures/logo.png"
  ]
}

示例：创建草稿

{
  "to": ["[email protected]"],
  "subject": "資料",
  "body": "添付しています。",
  "attachments": ["/absolute/path/to/file.txt"]
}

注意事项：

• 总大小上限约为 24 MB，超过此限制会报错（为 Gmail 的 25 MB 限制预留了安全余量）。
• MIME 类型会自动推断。无法识别时，将以 application/octet-stream 发送。
• 文件不存在或无法读取时会报错。

📄 许可证

本项目依据 MIT 许可证提供，详情请参阅 LICENSE 文件。

---

📋 西班牙语文档

欢迎向此仓库提交拉取请求。

📖 目录

• 概述
• 功能
• 先决条件
• 设置
• 使用方法
• 许可证

🔍 概述

Gmail MCP 是一种 MCP（Model Context Protocol）服务实现，可让 AI 助手通过 MCP 与 Gmail 交互。它提供用于发送电子邮件、管理草稿、阅读邮件、搜索收件箱以及管理 Gmail 标签的工具。

✨ 功能

• ✉️ 发送电子邮件和创建草稿
• 📬 阅读和搜索邮件
• 🗑️ 删除邮件
• 🏷️ 管理 Gmail 标签（创建、更新、删除）
• 🔐 使用 Gmail API 进行 OAuth2.0 身份验证

📋 先决条件

• Python 3.11 或更高版本
• Gmail 账号
• 已启用 Gmail API 的 Google Cloud Platform 项目
• uv - Python 包安装程序

🚀 设置

1. 克隆此仓库

git clone https://github.com/ykuchiki/gmail-mcp.git
cd gmail-mcp

2. 创建并启用虚拟环境

uv init

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 服务 请参阅 MCP 客户端的官方文档，了解具体说明。请确保根据你的环境调整路径。

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

6. 运行服务

uv run main.py

💡 使用方法

此服务可与任何兼容 MCP 的客户端配合使用。首次运行时，系统会提示你使用 Gmail 账号进行身份验证。

📄 许可证

本项目依据 MIT 许可证授权，详情请参阅 LICENSE 文件。

---

待办事项

• 实现基本功能
• 在 search_emails 中排除已发送邮件 ID，或采用其他方式实现