技能介绍

解决什么问题

在 Gmail、Calendar、Drive、Docs、Sheets 和 Slides 之间做跨产品操作时，常见痛点是工具链太薄：只能发邮件或只能读日历，查文件夹还要处理 folder ID 与文件夹名混淆。google-workspace-operator 面向个人 Google 账号场景，提供 24 个 Direct OAuth 工具，直接调用 googleapis.com，不依赖 MCP、第三方网关或 IMAP App Password。

技能如何工作

核心能力围绕“先查询、再执行”的闭环：

Gmail：gmail_messages_list 搜索、gmail_message_send 发纯文本、gmail_message_modify 加标签或归档。
Calendar：创建、列出、读取、删除事件，时间使用 RFC3339。
Drive：用 Drive query language 找文件和文件夹；文件夹内容必须先用名称找 id，再用 '' in parents 列内容。
Docs / Sheets / Slides：创建、读取结构化内容，Docs 用 docs_append_text 追加，Sheets 用 sheets_values_append 写行。

关键约束是工具状态会变化：用户问“到了吗 / 新东西”时，应重新调用工具，而不是复用上轮结果。遇到 invalid_grant 或文件未找到时，下一步应修正参数再调用，或只问真正缺少的信息。

适用边界

它适合个人账号自动化，不做 Workspace 管理后台操作，也不编辑本地文件；docs_append_text 只针对 Google Docs。目前发送 Gmail 仅纯文本，尚无附件、OCR、图片生成、资源预约或完整免费/忙碌查询。drive_permission_create 会真实分享文件，只有用户明确要求时才调用。