Automação de Google Docs via Rube MCP (Composio)

Automação de Google Docs via Rube MCP

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

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

Pré-requisitos

• O 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 atuais das ferramentas

Configuração

Obter 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 ele 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 que o status da conexão está ATIVO antes de executar qualquer fluxo 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.

Ferramenta: GOOGLEDOCS_CREATE_DOCUMENT
Parâmetros:
  - title (obrigatório): Nome/título do arquivo do documento
  - text (obrigatório): Conteúdo de texto inicial a ser inserido no documento

2. Pesquisar Documentos

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

Ferramenta: GOOGLEDOCS_SEARCH_DOCUMENTS
Parâmetros:
  - query: String de consulta de pesquisa
  - max_results: Limitar número de resultados
  - modified_after / created_after: Filtrar por data
  - shared_with_me: Filtrar documentos compartilhados
  - starred_only: Filtrar documentos com estrela
  - include_shared_drives: Pesquisar drives compartilhados
  - order_by: Classificar resultados
  - page_token: Token de paginação

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.

Ferramenta: GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN
Parâmetros:
  - id (obrigatório): ID do documento
  - markdown (obrigatório): Conteúdo Markdown para substituir todo o corpo do documento

4. Localizar e Substituir Texto

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

Ferramenta: GOOGLEDOCS_REPLACE_ALL_TEXT
Parâmetros:
  - document_id (obrigatório): ID do documento de destino
  - find_text (obrigatório): Texto a ser pesquisado
  - replace_text (obrigatório): Texto de substituição
  - match_case: Correspondência com distinção entre maiúsculas e minúsculas (booleano)
  - search_by_regex: Usar regex para find_text
  - tab_ids: Guias específicas a serem pesquisadas

5. Exportar Documento como PDF

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

Ferramenta: GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF
Parâmetros:
  - file_id (obrigatório): ID do arquivo do documento
  - filename: Nome do arquivo PDF de saída

6. Copiar um Documento

Use GOOGLEDOCS_COPY_DOCUMENT para duplicar um Google Doc existente.

Ferramenta: GOOGLEDOCS_COPY_DOCUMENT
Parâmetros:
  - document_id (obrigatório): ID do documento de origem a ser copiado
  - title: Título para a nova cópia
  - include_shared_drives: Pesquisar drives compartilhados pela origem

Padrões Comuns

• Pesquisar e 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 modelo: Use GOOGLEDOCS_COPY_DOCUMENT para duplicar um modelo, depois GOOGLEDOCS_REPLACE_ALL_TEXT para preencher o texto do espaço reservado.
• Recuperar e atualizar: Use GOOGLEDOCS_GET_DOCUMENT_BY_ID para ler o conteúdo atual e depois aplique edições com GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT.
• Inserção em lote de texto: 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 googledrive) para compartilhar documentos após a criação.

Armadilhas Conhecidas

• GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN substitui o conteúdo inteiro do documento — não anexa. Use apenas para reescritas completas.
• GOOGLEDOCS_INSERT_TEXT_ACTION requer um insertion_index preciso (posição de 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 requisição editDocs com requisições brutas de atualização em lote da API do Google Docs — consulte a documentação da API para a estrutura correta.
• Os IDs de documento e IDs de arquivo têm o mesmo valor para Google Docs, mas os nomes dos parâmetros variam entre as ferramentas (id, document_id, file_id).
• GOOGLEDOCS_SEARCH_DOCUMENTS usa a sintaxe de pesquisa do Google Drive para o parâmetro query (ex.: name contains 'report').

Referência Rápida

Ação	Ferramenta	Parâmetros Principais
Criar documento	GOOGLEDOCS_CREATE_DOCUMENT	title, text
Pesquisar documentos	GOOGLEDOCS_SEARCH_DOCUMENTS	query, max_results, modified_after
Obter documento por ID	GOOGLEDOCS_GET_DOCUMENT_BY_ID	id
Atualizar com Markdown	GOOGLEDOCS_UPDATE_DOCUMENT_MARKDOWN	id, markdown
Edições programáticas	GOOGLEDOCS_UPDATE_EXISTING_DOCUMENT	document_id, editDocs
Inserir texto	GOOGLEDOCS_INSERT_TEXT_ACTION	document_id, text_to_insert, insertion_index
Localizar e substituir	GOOGLEDOCS_REPLACE_ALL_TEXT	document_id, find_text, replace_text
Exportar como PDF	GOOGLEDOCS_EXPORT_DOCUMENT_AS_PDF	file_id, filename
Copiar documento	GOOGLEDOCS_COPY_DOCUMENT	document_id, title

---

Desenvolvido por Composio