Gmail MCP

🚀 增强版 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 配置

1. 创建一个 新 Google Cloud 项目
2. 启用 Gmail API
3. 创建 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。

1. 叉仓库
2. 创建功能分支 (git checkout -b feature/amazing-feature)
3. 提交更改 (git commit -m '添加一些神奇的功能')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开 Pull Request

📄 许可证

本项目根据 GPL-3.0 许可证发布 - 请查看 LICENSE 文件了解详细信息。

🙏 致谢

• 受到社区中各种 MCP 服务器实现的启发
• 使用 Google 的官方 API 客户端库构建