Gmail MCP

基本能力

产品定位

Gmail MCP 是一个为 AI 助手设计的 Gmail API 服务，通过 MCP 协议实现与 Gmail 的交互。

核心功能

• ✉️ 发送邮件和创建草稿
• 📬 阅读和搜索邮件
• 🗑️ 删除邮件
• 🏷️ 管理 Gmail 标签（创建、更新、删除）
• 🔐 通过 OAuth2.0 与 Gmail API 进行认证

适用场景

• AI 助手需要发送或管理邮件
• 自动化邮件处理流程
• 邮件分类和标签管理

工具列表

• uv: Python 包安装工具，用于安装项目依赖
• Gmail API: 提供邮件发送、接收、搜索等功能

常见问题解答

• 需要 Python 3.11 或更高版本
• 需要有效的 Gmail 账户和 Google Cloud Platform 项目
• 初次运行需要 OAuth2.0 认证

使用教程

使用依赖

• Python 3.11 或更高版本
• Gmail 账户
• Google Cloud Platform 项目，已启用 Gmail API
• uv Python 包安装工具

安装教程

1. 克隆仓库

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

1. 创建并激活虚拟环境

uv init

1. 安装依赖

uv pip install -r requirements.txt

1. 设置 OAuth 认证
2. 在项目根目录创建 credentials 目录
3. 在 Google Cloud Console 创建项目并启用 Gmail API
4. 创建 OAuth 认证信息
5. 下载认证 JSON 文件并保存为 credentials/client_secret_gmail_oauth.json
6. 添加 MCP 服务器

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

1. 运行服务器

uv run main.py

调试方式

• 初次运行会提示进行 Gmail 账户认证
• 确保所有依赖已正确安装
• 检查 credentials 目录和文件路径是否正确

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。