核心功能
gogcli-mcp 是一个 MCP 服务器封装层,基于 gogcli 构建,为 Claude 提供完整的 Google Workspace 生态接入能力。涵盖 8 大核心服务、52 个工具函数:
- Sheets(8 项):读取、更新、追加、清空、元数据查询、创建、查找替换、批量运行
- Docs(7 项):文档信息、内容读取、创建、写入、查找替换、结构解析、批量运行
- Gmail(4 项):邮件搜索、读取、发送、批量运行
- Calendar(7 项):事件列表、获取、创建、更新、删除、响应邀请、批量运行
- Drive(9 项):文件列表、搜索、获取、创建目录、重命名、移动、删除、分享、批量运行
- Tasks(7 项):任务列表管理、列表查看、获取、添加、完成、删除、批量运行
- Contacts(5 项):联系人搜索、列表、获取、创建、批量运行
- Auth(5 项):账户列表、状态检查、服务授权、添加账户、批量运行
显著优点
- 覆盖全面:单一工具包覆盖办公场景最常用的 Google 服务,无需多服务器配置
- 粒度精细:每个服务提供原子化操作(如 Drive 单独区分 mkdir/rename/move/delete)
- 多账户支持:通过
account参数或GOG_ACCOUNT环境变量灵活切换身份 - 批量能力:各服务均支持
run工具,可组合执行复杂工作流
局限性与风险
- 外部依赖:需预装 gogcli 并完成 OAuth 认证流程
- 环境要求:Node.js 18+,对旧系统存在兼容性门槛
- 权限敏感:涉及邮件、联系人、文件全生命周期管理,需严格管控 OAuth 范围
- 无内置缓存:高频调用可能触发 Google API 配额限制
适合人群
- 企业办公自动化开发者
- 需要批量处理 Google Workspace 数据的分析师
- 构建邮件/日程/文档智能助手的 AI 应用开发者
安全建议
- 启用最小权限原则,定期审查 OAuth 授权范围
- 生产环境建议使用服务账号而非个人 OAuth 凭证
- 避免在共享环境硬编码
GOG_ACCOUNT