name: googledocs-automation description: “通过Rube MCP（Composio）自动化Google Docs任务：创建、编辑、搜索、导出、复制和更新文档。始终先搜索工具以获取当前模式。” requires: mcp: [rube]

通过Rube MCP的Google文档自动化

使用Rube MCP（Composio）编程式地创建、编辑、搜索、导出和管理Google Docs文档。

工具包文档: composio.dev/toolkits/googledocs

前提条件

Rube MCP必须连接（RUBE_SEARCH_TOOLS可用）
通过RUBE_MANAGE_CONNECTIONS与工具包googledocs的活动连接
总是先调用RUBE_SEARCH_TOOLS以获取当前工具模式

设置

获取Rube MCP: 在您的客户端配置中将https://rube.app/mcp添加为MCP服务器。无需API密钥 — 只需添加端点即可工作。

确认Rube MCP可用，通过确认RUBE_SEARCH_TOOLS响应
调用RUBE_MANAGE_CONNECTIONS，工具包为googledocs
如果连接未激活，按照返回的授权链接完成设置
在运行任何工作流之前，确认连接状态显示为激活

核心工作流

1. 创建新文档

使用GOOGLEDOCS_CREATE_DOCUMENT创建具有标题和初始文本内容的新Google文档。

Tool: GOOGLEDOCS_CREATE_DOCUMENT
Parameters:
  - title (required): 文档文件名/标题
  - text (required): 插入到文档的初始文本内容

2. 搜索文档

使用GOOGLEDOCS_SEARCH_DOCUMENTS通过名称、内容、日期或共享状态查找Google文档。

Tool: GOOGLEDOCS_SEARCH_DOCUMENTS
Parameters:
  - query: 搜索查询字符串
  - max_results: 限制结果数量
  - modified_after / created_after: 按日期过滤
  - shared_with_me: 过滤共享文档
  - starred_only: 过滤星标文档
  - include_shared_drives: 搜索共享驱动器
  - order_by: 排序结果
  - page_token: 分页标记

3. 使用Markdown更新文档内容

使用GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN用Markdown格式的文本替换整个文档内容。

Tool: GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN
Parameters:
  - id (required): 文档ID
  - markdown (required): Markdown内容以替换整个文档正文

4. 查找和替换文本

使用GOOGLEDOCS_REPLACE_ALL_TEXT替换文档中所有出现的字符串。

Tool: GOOGLEDOCS_REPLACE_ALL_TEXT
Parameters:
  - document_id (required): 目标文档ID
  - find_text (required): 要搜索的文本
  - replace_text (required): 替换文本
  - match_case: 区分大小写匹配（布尔值）
  - search_by_regex: 使用正则表达式查找文本
  - tab_ids: 要搜索的特定标签页

5. 将文档导出为PDF

使用GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF将Google文档导出为PDF格式。

Tool: GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF
Parameters:
  - file_id (required): 文档文件ID
  - filename: 输出PDF文件名

6. 复制文档

使用GOOGLEDOCS_COPY_DOCUMENT复制现有的Google文档。

Tool: GOOGLEDOCS_COPY_DOCUMENT
Parameters:
  - document_id (required): 要复制的源文档ID
  - title: 新副本的标题
  - include_shared_drives: 在共享驱动器中搜索源

常见模式

搜索然后编辑: 使用GOOGLEDOCS_SEARCH_DOCUMENTS按名称查找文档，然后使用返回的文档ID与GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN或GOOGLEDOCS_REPLACE_ALL_TEXT进行修改。
从模板创建: 使用GOOGLEDOCS_COPY_DOCUMENT复制模板，然后使用GOOGLEDOCS_REPLACE_ALL_TEXT填充占位符文本。
检索然后更新: 使用GOOGLEDOCS_GET_DOCUMENT_BY_ID读取当前内容，然后使用GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT应用编辑。
批量文本插入: 使用GOOGLEDOCS_INSERT_TEXT_ACTION在特定位置（按索引）或文档末尾插入文本。
共享文档: 结合GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE（googledrive工具包）在创建后共享文档。

已知陷阱

GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN替换整个文档内容 — 它不会追加。仅用于完全重写。
GOOGLEDOCS_INSERT_TEXT_ACTION需要精确的insertion_index（字符位置）。设置append_to_end: true以安全地在末尾添加文本。
GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT需要构建editDocs请求体与原始Google Docs API批量更新请求 — 请参考API文档以获取正确结构。
文档ID和文件ID对于Google文档是相同的值，但参数名称在不同工具中不同（id、document_id、file_id）。
GOOGLEDOCS_SEARCH_DOCUMENTS使用Google Drive搜索语法作为query参数（例如，name contains 'report'）。

快速参考

动作	工具	关键参数
创建文档	`GOOGLEDOCS_CREATE_DOCUMENT`	`title`、`text`
搜索文档	`GOOGLEDOCS_SEARCH_DOCUMENTS`	`query`、`max_results`、`modified_after`
按ID获取文档	`GOOGLEDOCS_GET_DOCUMENT_BY_ID`	`id`
使用Markdown更新	`GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN`	`id`、`markdown`
编程式编辑	`GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT`	`document_id`、`editDocs`
插入文本	`GOOGLEDOCS_INSERT_TEXT_ACTION`	`document_id`、`text_to_insert`、`insertion_index`
查找和替换	`GOOGLEDOCS_REPLACE_ALL_TEXT`	`document_id`、`find_text`、`replace_text`
导出为PDF	`GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF`	`file_id`、`filename`
复制文档	`GOOGLEDOCS_COPY_DOCUMENT`	`document_id`、`title`