核心用法
gogcli-mcp 是一套基于 Model Context Protocol (MCP) 的 Google Workspace 自动化工具集，采用单体仓库架构，包含 6 个专用子包：
| 子包 | 核心功能 |
|------|---------|
| `gogcli-mcp` | 伞形主包（Sheets 为主 + Docs/Drive 辅助） |
| `gogcli-mcp-docs` | Google Docs 创建、读取、编辑、查找替换、批注 |
| `gogcli-mcp-sheets` | 单元格操作、区域管理、公式、图表、命名范围 |
| `gogcli-mcp-slides` | 演示文稿与单页幻灯片创作 |
| `gogcli-mcp-drive` | 文件搜索、上传下载、权限管理 |
| `gogcli-mcp-classroom` | 课程管理、作业布置、提交批改、花名册 |
安装模式灵活：可按需安装单个子包，或通过 gogcli-mcp umbrella 包一键启用全部功能。
认证机制统一：所有子包共享底层的 gogcli CLI 认证体系，执行 gogcli auth add 完成一次 OAuth 授权后，各 MCP 服务均可访问对应 Google 账号数据。支持多账号场景通过 GOG_ACCOUNT 环境变量切换。
显著优点
1. 协议标准化：基于 MCP 协议设计，与 Anthropic Claude Desktop、Cursor 等主流 AI IDE 原生兼容
2. 粒度精细：工具命名采用 gog_<service>_<action> 前缀规范，6 个子包 API 隔离清晰，避免权限过度授予
3. 部署零配置：npx -y 直接运行，无需全局安装，符合现代 Node.js 工具链最佳实践
4. 教育场景完整覆盖：Classroom 子包填补了 Google Workspace MCP 生态中教育管理的空白
潜在局限
- 外部依赖刚性：必须预先安装并配置
gogcli二进制文件，增加了部署复杂度 - OAuth 令牌本地存储：
gogcli将认证信息保存在本地文件系统，多设备同步需手动处理 - Google API 配额限制：受限于 Workspace API 的速率限制，大规模批量操作可能触发限流
- 功能边界依赖 gogcli：MCP 层仅为包装层，核心功能演进受上游
gogcli项目制约
适合人群
- 知识工作者：需通过自然语言指令批量处理 Google 文档、表格的内容创作者
- 教育从业者：使用 Google Classroom 管理课程、自动化作业收集与评分的教师
- 自动化开发者：构建基于 LLM 的 Workspace 工作流，需结构化 API 访问的工程师
常规风险
- OAuth 范围宽泛：Google Workspace API 授权通常请求
drive、spreadsheets、docs等广泛范围，存在权限最小化配置的挑战 - 令牌泄露风险：本地存储的
gogcli凭证若未加密，在多用户环境可能被窃取 - API 变更兼容性：Google API 的弃用策略可能导致子包功能突然中断
- 操作不可逆性：批量写入、删除类工具缺乏原生撤销机制，误操作可能影响生产数据
建议生产环境启用 Google Workspace 审计日志，并定期轮换 OAuth 凭据。