🚀 增强版 Gmail MCP 服务器
增强版 Gmail MCP 服务器是一个强大且功能丰富的模型上下文协议（MCP）服务器，由 Python 编写，可与 Gmail 集成。它能让 AI 助手（如 Claude）通过自然语言与 Gmail 交互，提供全面的电子邮件管理功能。
🚀 快速开始
先决条件
- 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 2.0 凭证并下载 JSON 文件
配置服务器
编辑配置文件 config.py：
# 配置 Gmail 帐户信息
GMAIL_ACCOUNT = 'your_email@gmail.com'
GMAIL_PASSWORD = 'your_password'
# 配置 OAuth 2.0 凭证路径
CREDENTIALS_FILE = 'path/to/credentials.json'
启动服务器
运行以下命令启动 MCP 服务器：
python server.py
✨ 主要特性
📧 完整的电子邮件管理
- 发送带有自定义主题、内容和收件人的电子邮件
- 阅读并检索电子邮件正文及其全部元数据
- 将电子邮件移到垃圾箱并确认
- 标记电子邮件为已读/未读
- 直接在浏览器中打开电子邮件
📝 草稿管理
- 创建草稿邮件以供稍后审阅
- 列出所有草稿邮件
- 编辑现有草稿
🏷️ 高级标签管理
- 列出所有可用的标签
- 创建自定义标签
- 为电子邮件添加/移除标签
- 重命名现有标签
- 删除未使用的标签
- 按标签搜索邮件
📁 文件夹组织
- 创建新文件夹（实现为 Gmail 标签）
- 在文件夹之间移动电子邮件
- 列出所有可用的文件夹
🔍 强大搜索与过滤功能
- 使用 Gmail 的高级查询语法搜索邮件
- 管理和删除电子邮件过滤器
- 按发件人、收件人、主题、内容等进行过滤
- 通过灵活参数自定义搜索结果
🗄️ 存档管理
- 存档电子邮件（从收件箱中移除但不删除）
- 批量存档符合搜索标准的多个电子邮件
- 列出所有已存档邮件
- 将已存档邮件恢复到收件箱
🤝 贡献
欢迎贡献！请随意提交 Pull Request。
- 叉仓库
- 创建功能分支 (
git checkout -b feature/amazing-feature) - 提交更改 (
git commit -m '添加一些神奇的功能') - 推送到分支 (
git push origin feature/amazing-feature) - 打开 Pull Request
📄 许可证
本项目根据 GPL-3.0 许可证发布 - 请查看 LICENSE 文件了解详细信息。
🙏 致谢
- 受到社区中各种 MCP 服务器实现的启发
- 使用 Google 的官方 API 客户端库构建