Automação do Google Docs com Rube MCP

Crie, edite, pesquise, exporte e gerencie documentos do Google Docs programaticamente usando Rube MCP (Composio).

Documentação do Toolkit: composio.dev/toolkits/googledocs

Pré-requisitos

• Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponível)
• Conexão ativa via RUBE_MANAGE_CONNECTIONS com o toolkit googledocs
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obtenha o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na configuração do seu cliente. Nenhuma chave de API é necessária — basta adicionar o endpoint e funciona.

1. Verifique se o Rube MCP está disponível confirmando que RUBE_SEARCH_TOOLS responde
2. Chame RUBE_MANAGE_CONNECTIONS com o toolkit googledocs
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para concluir a configuração
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Criar um Novo Documento

Use GOOGLEDOCS_CREATE_DOCUMENT para criar um novo Google Doc com um título e conteúdo de texto inicial.

Tool: GOOGLEDOCS_CREATE_DOCUMENT
Parameters:
  - title (required): Document filename/title
  - text (required): Initial text content to insert into the document

2. Pesquisar Documentos

Use GOOGLEDOCS_SEARCH_DOCUMENTS para encontrar Google Docs por nome, conteúdo, data ou status de compartilhamento.

Tool: GOOGLEDOCS_SEARCH_DOCUMENTS
Parameters:
  - query: Search query string
  - max_results: Limit number of results
  - modified_after / created_after: Filter by date
  - shared_with_me: Filter shared documents
  - starred_only: Filter starred documents
  - include_shared_drives: Search shared drives
  - order_by: Sort results
  - page_token: Pagination token

3. Atualizar Conteúdo do Documento com Markdown

Use GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN para substituir todo o conteúdo de um documento por texto formatado em Markdown.

Tool: GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN
Parameters:
  - id (required): Document ID
  - markdown (required): Markdown content to replace entire document body

4. Encontrar e Substituir Texto

Use GOOGLEDOCS_REPLACE_ALL_TEXT para substituir todas as ocorrências de uma string em um documento.

Tool: GOOGLEDOCS_REPLACE_ALL_TEXT
Parameters:
  - document_id (required): Target document ID
  - find_text (required): Text to search for
  - replace_text (required): Replacement text
  - match_case: Case-sensitive matching (boolean)
  - search_by_regex: Use regex for find_text
  - tab_ids: Specific tabs to search

5. Exportar Documento como PDF

Use GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF para exportar um Google Doc para o formato PDF.

Tool: GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF
Parameters:
  - file_id (required): Document file ID
  - filename: Output PDF filename

6. Copiar um Documento

Use GOOGLEDOCS_COPY_DOCUMENT para duplicar um Google Doc existente.

Tool: GOOGLEDOCS_COPY_DOCUMENT
Parameters:
  - document_id (required): Source document ID to copy
  - title: Title for the new copy
  - include_shared_drives: Search shared drives for the source

Padrões Comuns

• Pesquisar e depois editar: Use GOOGLEDOCS_SEARCH_DOCUMENTS para encontrar um documento pelo nome, depois use o ID do documento retornado com GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN ou GOOGLEDOCS_REPLACE_ALL_TEXT para modificá-lo.
• Criar a partir de um modelo: Use GOOGLEDOCS_COPY_DOCUMENT para duplicar um modelo, depois GOOGLEDOCS_REPLACE_ALL_TEXT para preencher o texto do espaço reservado.
• Recuperar e depois atualizar: Use GOOGLEDOCS_GET_DOCUMENT_BY_ID para ler o conteúdo atual, depois aplique edições com GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT.
• Inserção de texto em lote: Use GOOGLEDOCS_INSERT_TEXT_ACTION para inserir texto em posições específicas (por índice) ou anexar ao final de um documento.
• Compartilhar documentos: Combine com GOOGLEDRIVE_ADD_FILE_SHARING_PREFERENCE (toolkit do googledrive) para compartilhar documentos após a criação.

Armadilhas Conhecidas

• GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN substitui todo o conteúdo do documento — ele não anexa. Use-o apenas para reescritas completas.
• GOOGLEDOCS_INSERT_TEXT_ACTION requer um insertion_index preciso (posição do caractere). Defina append_to_end: true para adicionar texto com segurança ao final.
• GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT requer a construção de um corpo de solicitação editDocs com requisições de atualização em lote da API bruta do Google Docs — consulte a documentação da API para a estrutura correta.
• IDs de documentos e IDs de arquivos são o mesmo valor para Google Docs, mas os nomes dos parâmetros diferem entre as ferramentas (id, document_id, file_id).

…