Gmail MCP Server

基本能力

产品定位

Quantum-369_Gmail-mcp-server 是一个专注于 Gmail 集成的服务器，旨在为开发者提供强大的电子邮件管理功能。

核心功能

• 从多个 Gmail 账户读取电子邮件
• 发送带附件的电子邮件
• 使用高级查询选项搜索电子邮件
• 下载电子邮件附件
• 处理电子邮件对话和线程
• 实时电子邮件监控
• 支持多个 Gmail 账户

适用场景

• 自动化电子邮件处理
• 批量发送电子邮件
• 电子邮件监控和警报
• 电子邮件数据分析和报告

工具列表

1. Send Email: 发送电子邮件，支持附件。
2. Search Emails: 使用高级查询选项搜索电子邮件。
3. Read Latest Emails: 读取最新的电子邮件。
4. Download Attachments: 下载电子邮件附件。

常见问题解答

• 如何获取 Google Cloud Project 的 OAuth 2.0 凭证？ 需要在 Google Cloud Console 中创建项目并启用 Gmail API，然后创建 OAuth 2.0 客户端 ID。
• 如何存储敏感信息？ 建议使用环境变量存储敏感信息，并将 client_secret.json 文件添加到 .gitignore 中。

使用教程

使用依赖

1. Python 3.12 或更高版本
2. 启用了 Gmail API 的 Google Cloud Project
3. OAuth 2.0 客户端 ID 凭证
4. 所需的 Python 包（在 pyproject.toml 中指定）

安装教程

1. 克隆仓库：

git clone <your-repository-url>
cd gmail-mcp-server

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

python -m venv venv
# On Windows
venv\Scripts\activate
# On Unix/MacOS
source venv/bin/activate

1. 安装依赖：

pip install .

调试方式

1. 启动服务器：

python gmail_server.py

1. 使用提供的工具进行测试，如发送电子邮件或搜索电子邮件。
2. 查看日志文件 gmail_mcp.log 以获取调试信息。

许可证

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