核心功能
gogcli-mcp 是一款 MCP(Model Context Protocol)服务器,它将 Claude 与完整的 Google Workspace 生态打通。该工具封装了开源命令行工具 gogcli,提供 52 个细粒度 API 工具,覆盖七大服务类别:
- Sheets(8项):读取、更新、追加、清空、获取元数据、创建、查找替换、批量执行
- Docs(7项):文档信息、内容读取、创建、写入、查找替换、结构分析、批量执行
- Gmail(4项):邮件搜索、获取详情、发送邮件、批量执行
- Calendar(7项):事件列表、详情获取、创建、更新、删除、邀请响应、批量执行
- Drive(9项):目录浏览、搜索、文件获取、创建文件夹、重命名、移动、删除、权限共享、批量执行
- Tasks(7项):任务列表管理、单列表操作、任务获取、添加、完成标记、删除、批量执行
- Contacts(5项):联系人搜索、列表、详情、创建、批量执行
- Auth(5项):账户管理、服务状态、授权管理
显著优势
1. 一站式集成:单工具覆盖 Google Workspace 全栈,无需切换多个 MCP 服务器
2. 灵活的账户切换:支持 GOG_ACCOUNT 环境变量默认配置,同时允许单次调用通过 account 参数覆盖
3. 批量执行能力:每个服务均提供 run 工具,支持复杂工作流的原子化操作
4. 零服务依赖:完全基于本地 gogcli 二进制文件,不依赖云端中间件
局限性与风险
核心依赖风险:必须预先安装并认证 gogcli,OAuth 令牌存储于本地,若设备失守则 Google 账户面临完全暴露风险。
权限范围极宽:gogcli 通常申请完整 Google Workspace 读写权限,远超最小权限原则。
无沙箱隔离:工具直接操作真实生产数据,误操作可能导致邮件误发、文档删除、日历事件丢失等不可逆后果。
审计盲区:操作日志分散于 gogcli 本地与 Google 服务端,缺乏统一审计视图。
Node.js 依赖:要求 Node 18+ 环境,对纯 Python 或容器化部署场景增加复杂度。
适用人群
- 重度 Google Workspace 用户,需在 Claude 对话中直接操作邮件、日程、文档
- 自动化工作流开发者,构建基于自然语言的办公自动化管线
- 具备 OAuth 安全意识的个人用户或小型团队
使用建议
建议配合只读 OAuth 范围先行测试,严格限制生产环境的令牌有效期,定期轮换凭证,并在关键操作前启用人工确认机制。