Gmail-MCP-Server

🚀 Gmail 自动化控制面板服务器端

Gmail 自动化控制面板 (MCP) 是一款强大的工具，可通过命令行对 Gmail 账户进行全面自动化管理。它支持 OAuth 2.0 认证，还提供丰富的 API 接口，能实现电子邮件的批量操作，极大提升管理效率。

🚀 快速开始

Gmail 自动化控制面板 (MCP) 可通过命令行对 Gmail 账户进行全面自动化管理。它支持 OAuth 2.0 认证，还提供丰富的 API 接口，能实现电子邮件的批量操作，极大提升管理效率。

📦 安装指南

安装依赖

pip install google.oauth2 googleapiclient gmail-mcp

初始化配置

创建一个空白的 YAML 配置文件：

mkdir -p ~/.gmail-mcp && touch ~/.gmail-mcp/config.yaml

认证流程

运行以下命令启动 OAuth 认证流程：

python -m gmail_mcp.auth

按照提示完成 Google 的 OAuth 同意流程。

✨ 主要特性

工具列表

以下是 Gmail MCP 提供的主要工具及其功能说明：

| 工具名称 | 功能描述 | |---------|--------| | gmail.search | 根据指定查询搜索电子邮件 | | gmail.fetch | 按条件获取电子邮件 | | gmail.label | 管理电子邮件标签（创建、修改、删除） | | gmail.batch | 执行批量操作（发送、删除等） | | gmail.attachment | 下载或管理附件 | | gmail.header | 操作邮件头信息 | | gmail.body | 获取或设置邮件正文内容 | | gmail.star | 标记/取消标记邮件为星标 | | gmail.spam | 移动到垃圾邮件文件夹或恢复邮件 | | gmail.draft | 管理草稿邮件 | | gmail.sent | 操作已发送邮件 | | gmail.trash | 移动邮件到回收站或删除 |

高级搜索语法

Gmail MCP 支持以下高级搜索运算符：

| 运算符 | 示例 | 描述 | |--------|------|-----| | from: | from:john@example.com | 搜索来自特定发件人的邮件 | | to: | to:mary@example.com | 搜索发送给特定收件人的邮件 | | subject: | subject:"meeting notes" | 搜索主题包含指定文字的邮件 | | has:attachment | has:attachment | 搜索带有附件的邮件 | | after: | after:2024/01/01 | 搜索在指定日期之后收到的邮件 | | before: | before:2024/02/01 | 搜索在指定日期之前收到的邮件 | | is: | is:unread | 搜索未读状态的邮件 | | label: | label:work | 搜索具有特定标签的邮件 |

标签管理

Gmail MCP 提供全面的标签管理功能，包括：

• 创建自定义标签
• 更新现有标签信息
• 删除用户创建的标签
• 获取所有系统和自定义标签列表

📚 详细文档

安全注意事项

⚠️ 重要提示

• 通过 OAuth 2.0 进行身份验证，默认启用两步验证。
• 所有 API 请求均使用 SSL 加密通道进行传输。
• 支持基于角色的访问控制（RBAC），默认只允许授权用户操作。

故障排除

💡 使用建议

• 若无法连接到 Gmail 服务器，可检查网络连接或尝试更换 DNS 服务提供商。
• 若认证失败，需确保 OAuth 令牌有效且未过期。
• 若搜索结果为空，可验证搜索条件是否正确，或者检查邮件是否存在特定标签。

贡献指南

欢迎贡献代码！请参考项目仓库中的 CONTRIBUTING.md 文件了解如何参与开发。

📄 许可证

此项目遵循 MIT 许可证协议。详细内容请查看 LICENSE 文件。

该工具旨在帮助开发者和系统管理员高效管理 Gmail 账户，支持通过脚本实现自动化邮件处理流程。