Enhanced Gmail MCP Server
2025.03.01
2
Python电子邮件管理Gmail集成AI助手交流协作
Enhanced Gmail MCP Server 是一个功能强大的模型上下文协议（MCP）服务器，专为Gmail集成设计，使用Python编写。该服务器使AI助手（如Claude）能够通过自然语言与Gmail交互，提供全面的电子邮件管理功能。
View on GitHub
Overview
基本能力
产品定位
Enhanced Gmail MCP Server 是一个专为Gmail设计的MCP服务器，旨在通过AI助手提供高级电子邮件管理功能。
核心功能
- 📧 完整的电子邮件管理：发送、读取、移动至垃圾箱、标记已读/未读、在浏览器中直接打开邮件。
- 📝 草稿管理：创建、列出、编辑草稿邮件。
- 🏷️ 高级标签管理：列出、创建、应用/移除、重命名、删除标签，按标签搜索邮件。
- 📁 文件夹组织：创建新文件夹（作为Gmail标签实现）、在文件夹间移动邮件、列出所有可用文件夹。
- 🔍 强大的搜索与过滤：使用Gmail的高级查询语法搜索邮件，创建、管理、删除邮件过滤器。
- 🗄️ 归档管理：归档邮件、批量归档匹配搜索条件的邮件、列出所有归档邮件、将归档邮件恢复到收件箱。
适用场景
- 通过AI助手管理Gmail邮件
- 发送和接收邮件
- 管理草稿和标签
- 组织和搜索邮件
- 创建和管理邮件过滤器
工具列表
- Gmail API：用于与Gmail服务交互的核心工具。
- OAuth 2.0：用于安全认证和授权。
- MCP Inspector：用于测试和调试MCP服务器。
常见问题解答
- 如何确保安全性？
- 不要将凭证或令牌文件提交到版本控制。
- 将凭证存储在安全位置，并设置适当的权限。
- 服务器在执行敏感操作前会请求用户确认。
- 定期检查Google Cloud Console以发现异常活动。
- 考虑使用环境变量存储敏感路径。
使用教程
使用依赖
- Python 3.8+
- 启用了Gmail API的Google Cloud项目
- OAuth 2.0凭证
安装教程
# 克隆仓库
git clone https://github.com/theposch/gmail-mcp.git
cd gmail-mcp
# 设置虚拟环境
python -m venv .venv
source .venv/bin/activate # Windows: .venv\Scripts\activate
# 安装包
pip install -e .
Google Cloud 设置
- 创建新的Google Cloud项目
- 启用Gmail API
- 配置OAuth同意屏幕:
- 选择"External"用户类型
- 添加您的电子邮件作为测试用户
- 添加范围:
https://www.googleapis.com/auth/gmail.modify - 创建OAuth 2.0凭证:
- 选择"Desktop app"作为应用类型
- 下载JSON凭证文件
配置
# 创建凭证目录
mkdir -p ~/.gmail-mcp
# 移动下载的凭证文件
mv ~/Downloads/client_secret_*.json ~/.gmail-mcp/credentials.json
调试方式
使用MCP Inspector进行测试和调试:
npx @modelcontextprotocol/inspector uv run /path/to/gmail-mcp/src/gmail/server.py --creds-file-path /path/to/credentials.json --token-path /path/to/tokens.json