用途
cursor-google-drive 是一份关于如何通过 MCP 工具操作 Google Drive 的源指引，覆盖搜索、读取、创建、整理、共享、评论和导出文件等任务。它适用于需要在指定文件夹中创建文件、查找最近处理的文件、把 Markdown 转成 Google Docs、把 CSV 转成 Google Sheets、复制模板、查看权限、添加评论或导出 PDF 等场景。
能力边界
资料明确指出，这是源指引，不是已安装的连接器，也不是运行时证明。使用前应针对当前宿主环境解析工具，并阅读其实际 schema。应保留指定的产品名称和请求结果；如果所需操作不可用，应报告其确切名称并让该步骤保持未完成。不得仅凭本文档编造工具名称、连接账户、安装辅助程序、花费金钱或扩大访问权限。当前操作者授权和原生权限约束每一项操作。
资料建议在可用时使用官方 Codex Google 插件及其所属技能。下文中的工具名称和 schema 细节描述的是上游连接器，并不构成对 Codex 插件的承诺。只有在检查暴露的 schema 之后，才能映射每个操作。如果官方插件缺少该操作，应指出缺口；未经明确授权，不得回退到 GOG 或其他凭据途径。不得为了满足图片 URL 要求而扩大共享范围或把私有图片设为公开。对于视觉工作，应应用可用的设计指引并检查导出结果。
文件 ID 与文件夹定位
每个工具都接收 Drive 文件 ID。ID 应来自搜索（或对已知文件夹使用 list_folder，对“我刚在做什么”使用 list_recent_files），或来自用户粘贴的 URL 中的 ID。对于已知文件名，exact_name 优于 query；可添加 mime_type_filter 以减少噪音。绝不能编造 ID，也不能复用陈旧对话中的 ID，应先重新搜索。
create_folder 接收 parent_folder_id；不传时文件夹会落在“我的云端硬盘”根目录。当用户指定目标文件夹时，应解析其 ID 并传入——在指定了文件夹的情况下却把文件创建在根目录，即使内容完美也是错误结果。
create_file 也接收 parent_folder_id，因此应直接把文件创建在所属位置，而不是先创建再移动。
Docs/Sheets/Slides 提供方自带的创建工具无法指定文件夹（其 API 没有 parent 参数）。当位置很重要时，要么用 create_file 在那里创建产物（Markdown 转 Doc，CSV 转 Sheet），要么先创建再用 move_or_rename 配合 destination_folder_id 移动。
move_or_rename 可在一次调用中完成移动或重命名，或两者兼做；重命名不会改变 ID。
update_file 是使用托管 Drive 工具参数名（fileId；title 重命名，parentId 通过替换当前父级来移动）的同一重命名/移动操作；它同时存在于翻译层和托管层，因此在需要两者都适用的指引中优先使用它。
授权限制：此应用的授权是 drive.file，因此移动到或写入此应用从未创建（且用户从未选择）的文件/文件夹可能返回 403。该 403 是权限事实，不是暂时性错误，不要重试。
Markdown 与 CSV 转换
create_file 配合 target_mime_type: application/vnd.google-apps.document 可在一次调用中把 Markdown（标题、列表、表格）转换为真正的 Google Doc；...spreadsheet 可把 CSV 转换为 Sheet。这是生成格式化 Doc 最快且正确的方式：当内容事先已知时，优先使用它而不是先创建再插入。update_file_content 以同样方式就地转换。
复制、元数据与共享
copy_file 复制文件（可选复制到文件夹中）——这是在不触碰原件的情况下实例化模板的正确方式。
get_file_metadata 返回完整记录（MIME 类型、父级、大小、所有者、修改时间）；用它确认移动是否到位。
get_file_permissions 列出谁有访问权限；share_file 向某个邮箱授予角色。仅在用户要求时共享；应报告链接，而不是推测性地扩大访问范围。
download_file 返回非 Google 文件（图片、PDF、纯文本）的原始字节，采用 base64 编码。
读取与导出
read_file 返回文本：Docs 以 Markdown 返回，Sheets 按标签页以 CSV 返回，Slides 以纯文本返回。用它来在写入后验证内容。
export_file 返回渲染后的字节，采用 base64 编码：Docs/Sheets/Slides 可导出 pdf（Sheets 的 PDF 会渲染每个标签页，包含图表），Drawings 可导出 png/svg，另有 office 格式（docx/xlsx/pptx）。当用户想看到最终外观时使用 PDF；导出上限为 10 MB。
若要把单张幻灯片导出为 PNG，应使用 google-slides 的 get_slide_thumbnail 工具，而不是 Drive 导出。
评论
评论存在于 Drive 文件上，因此一套工具即可覆盖 Docs、Sheets 和 Slides：
list_comments 返回每条评论的文本、引用的文档文本、解决状态和回复；它分页，因此在断定某条讨论串不存在之前应跟随 nextPageToken。
add_comment 添加文件级评论（无文本锚点）。
reply_to_comment 按评论 ID 回复，其 action: "resolve"（内容可选）是解决讨论串的唯一方式；编辑评论附近的文档文本永远不会解决它。不要动已解决的讨论串。
删除
trash_file 可恢复（约 30 天），对文件和文件夹都有效（被移入回收站的文件夹会带走其内容）。永久删除被有意设为不可用；绝不要承诺永久删除。
验证工作
创建和移动之后，用目标位置的 list_folder 或 get_file_metadata（检查 parents）确认放置位置。内容写入之后，read_file 是文本的基准事实，export_file（pdf）是渲染结果的基准事实。