🚀 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 账户，支持通过脚本实现自动化邮件处理流程。