核心功能
gogcli-mcp-gmail 是基于 gogcli 的 Gmail MCP 扩展服务,提供远超基础 Gmail 工具的 32 种专业邮件管理能力。
工具分类详解
读取工具组:支持原始 API JSON 导出、附件下载、线程网页链接生成、历史事件追踪,满足数据审计与备份需求。
线程管理:完整的线程级操作,包括获取完整对话、批量修改标签、一键提取线程内全部附件。
标签系统:从创建、重命名到删除的完整标签生命周期管理,支持批量线程标签修改。
批量操作引擎:支持按 ID 或搜索查询执行归档、标记已读/未读、移至垃圾箱、批量删除、批量标签修改,大幅提升邮件整理效率。
草稿工作流:完整的草稿生命周期——列出、获取、创建、更新、删除、发送,支持复杂邮件的渐进式撰写。
高级发送:原生支持邮件转发与自动回复功能,可基于查询条件批量回复。
系统级设置:通过 gog_gmail_run 管理过滤器、委托权限、转发规则、发送别名、休假自动回复及邮件追踪。
显著优势
- 功能覆盖度极高,几乎实现 Gmail Web 端全部能力
- 批量操作支持查询驱动,灵活处理大量邮件
- 标签系统完整,适合重度分类用户
- 草稿工作流完善,支持长邮件分次撰写
- 自动回复与转发自动化程度高
潜在局限
- 依赖外部 CLI 工具:需预先安装并认证 gogcli,配置门槛较高
- Node.js 版本要求:限制 Node 18+,旧环境需升级
- OAuth 认证复杂度:需处理 Gmail API 权限与令牌管理
- 无实时推送:基于轮询或主动调用,非事件驱动架构
适用人群
- 邮件处理量大的专业人士(每日 50+ 封邮件)
- 需要自动化邮件分类与归档的效率用户
- 频繁使用草稿功能进行协作沟通的用户
- 依赖 Gmail 过滤器与自动回复规则的高级用户
安全风险
- 全权限 OAuth:需要完整 Gmail 读写权限,泄露后果严重
- 环境变量暴露:
GOG_ACCOUNT等配置需妥善保管 - 批量操作不可逆:永久删除与批量修改无二次确认机制
- 自动回复误触发:基于查询的自动回复可能产生意外后果,建议先用小规模测试