Gmail MCP Server
2025.02.03
12
Python邮件服务自动化工具交流协作
Gmail MCP Server 是一个基于 MCP（Message Control Protocol）框架构建的强大且灵活的 Gmail 集成服务器。它提供了与 Gmail API 交互的健壮接口，支持通过编程方式读取、发送和管理电子邮件。该服务器适用于需要自动化处理 Gmail 邮件的场景，如批量发送邮件、邮件监控、附件下载等。
View on GitHub
Overview
基本能力
产品定位
Gmail MCP Server 是一个专注于 Gmail 邮件自动化处理的集成服务器，旨在为开发者提供便捷的 Gmail API 访问方式。
核心功能
- 从多个 Gmail 账户读取邮件
- 发送带附件的邮件
- 使用高级查询选项搜索邮件
- 下载邮件附件
- 处理邮件对话和线程
- 实时邮件监控
- 支持多个 Gmail 账户
适用场景
- 自动化邮件处理系统
- 批量邮件发送工具
- 邮件监控和提醒系统
- 邮件数据分析和归档
工具列表
- Send Email：发送邮件工具，支持带附件的邮件发送
- Search Emails：邮件搜索工具，支持高级查询
- Read Latest Emails：读取最新邮件工具
- Download Attachments：邮件附件下载工具
常见问题解答
- 如何获取 Google Cloud Project 凭证？ 需要创建 Google Cloud 项目并启用 Gmail API，然后创建 OAuth 2.0 凭证。
- 如何存储敏感信息？
建议使用环境变量存储敏感信息，并将凭证文件添加到
.gitignore。
使用教程
使用依赖
- Python 3.12 或更高版本
- 启用了 Gmail API 的 Google Cloud 项目
- OAuth 2.0 客户端 ID 凭证
- 所需的 Python 包（在 pyproject.toml 中指定）
安装教程
通过 Smithery 安装
npx -y @smithery/cli install @Quantum-369/Gmail-mcp-server --client claude
手动安装
- 克隆仓库：
git clone <your-repository-url>
cd gmail-mcp-server
- 创建并激活虚拟环境：
python -m venv venv
# Windows
venv\Scripts\activate
# Unix/MacOS
source venv/bin/activate
- 安装依赖：
pip install .
调试方式
- 启动服务器：
python gmail_server.py
- 使用工具进行测试：
await send_gmail(
email_identifier="[email protected]",
to="[email protected]",
subject="Test Subject",
body="Email body content",
attachment_paths=["path/to/attachment"]
)