Automação do Google Sheets via Rube MCP

Automatize fluxos de trabalho do Google Sheets, incluindo leitura/escrita de dados, gerenciamento de planilhas e abas, formatação de células, filtragem de linhas e upsert de registros através do kit de ferramentas do Google Sheets da Composio.

Pré-requisitos

• O Rube MCP deve estar conectado (RUBE_SEARCH_TOOLS disponíveis)
• Conexão ativa do Google Sheets via RUBE_MANAGE_CONNECTIONS com o kit de ferramentas googlesheets
• Sempre chame RUBE_SEARCH_TOOLS primeiro para obter os esquemas de ferramentas atuais

Configuração

Obter o Rube MCP: Adicione https://rube.app/mcp como um servidor MCP na sua configuração de 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 kit de ferramentas googlesheets
3. Se a conexão não estiver ATIVA, siga o link de autenticação retornado para completar o OAuth do Google
4. Confirme se o status da conexão mostra ATIVA antes de executar quaisquer fluxos de trabalho

Fluxos de Trabalho Principais

1. Ler e Escrever Dados

Quando usar: O usuário deseja ler dados de ou escrever dados em uma Planilha Google

Sequência de ferramentas:

1. GOOGLESHEETS_SEARCH_SPREADSHEETS - Encontrar planilha por nome se o ID for desconhecido [Pré-requisito]
2. GOOGLESHEETS_GET_SHEET_NAMES - Enumerar nomes de abas para direcionar a planilha correta [Pré-requisito]
3. GOOGLESHEETS_BATCH_GET - Ler dados de um ou mais intervalos [Obrigatório]
4. GOOGLESHEETS_BATCH_UPDATE - Escrever dados em um intervalo ou anexar linhas [Obrigatório]
5. GOOGLESHEETS_VALUES_UPDATE - Atualizar um único intervalo específico [Alternativa]
6. GOOGLESHEETS_SPREADSHEETS_VALUES_APPEND - Anexar linhas ao final da tabela [Alternativa]

Parâmetros chave:

• spreadsheet_id: ID alfanumérico do URL da planilha (entre '/d/' e '/edit')
• ranges: Matriz em notação A1 (por exemplo, 'Sheet1!A1:Z1000'); sempre use intervalos delimitados
• sheet_name: Nome da aba (correspondência insensível a maiúsculas/minúsculas suportada)
• values: Matriz 2D onde cada matriz interna é uma linha
• first_cell_location: Célula inicial em notação A1 (omitir para anexar)
• valueInputOption: 'USER_ENTERED' (analisado) ou 'RAW' (literal)

Armadilhas:

• Nomes de abas com maiúsculas/minúsculas incorretas ou inexistentes geram o erro "Sheet 'X' not found"
• Intervalos vazios podem omitir valueRanges[i].values; trate o ausente como uma matriz vazia
• Valores de GOOGLESHEETS_BATCH_UPDATE devem ser uma matriz 2D (lista de listas), mesmo para uma única linha
• Intervalos ilimitados como 'A:Z' em planilhas com mais de 10.000 linhas podem causar timeouts; sempre limite com limites de linha
• O anexo segue o tableRange detectado; use o updatedRange retornado para verificar a colocação

2. Criar e Gerenciar Planilhas

Quando usar: O usuário deseja criar uma nova planilha ou gerenciar abas dentro de uma

Sequência de ferramentas:

1. GOOGLESHEETS_CREATE_GOOGLE_SHEET1 - Criar uma nova planilha [Obrigatório]
2. GOOGLESHEETS_ADD_SHEET - Adicionar uma nova aba/planilha [Obrigatório]
3. GOOGLESHEETS_UPDATE_SHEET_PROPERTIES - Renomear, ocultar, reordenar ou colorir abas [Opcional]
4. GOOGLESHEETS_GET_SPREADSHEET_INFO - Obter metadados completos da planilha [Opcional]
5. GOOGLESHEETS_FIND_WORKSHEET_BY_TITLE - Verificar se uma aba específica existe [Opcional]

Parâmetros chave:

• title: Nome da planilha ou aba da planilha
• spreadsheetId: ID da planilha de destino
• forceUnique: Sufixo de anexo automático se o nome da aba existir (padrão true)
• properties.gridProperties: Definir contagens de linhas/colunas, linhas congeladas

Armadilhas:

• Nomes de abas devem ser únicos dentro de uma planilha
• Nomes de abas padrão dependem da localidade ('Sheet1' em inglês, 'Hoja 1' em espanhol)
• Não use index ao criar várias abas em paralelo (causa erros de 'índice muito alto')
• GOOGLESHEETS_GET_SPREADSHEET_INFO pode retornar 403 se a conta não tiver acesso

3. Pesquisar e Filtrar Linhas

Quando usar: O usuário deseja encontrar linhas específicas ou aplicar filtros aos dados da planilha

Sequência de ferramentas:

1. GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW - Encontrar a primeira linha que corresponde ao valor exato da célula [Obrigatório]
2. GOOGLESHEETS_SET_BASIC_FILTER - Aplicar filtro/classificação a um intervalo [Alternativa]
3. GOOGLESHEETS_CLEAR_BASIC_FILTER - Remover filtro existente [Opcional]
4. GOOGLESHEETS_BATCH_GET - Ler resultados filtrados [Opcional]

Parâmetros chave:

• query: Valor de texto exato a corresponder (corresponde ao conteúdo inteiro da célula)
• range: Intervalo em notação A1 para pesquisar
• case_sensitive: Booleano para correspondência sensível a maiúsculas/minúsculas (padrão false)
• filter.range: Intervalo de grade com sheet_id para filtro básico
• filter.criteria: Condições de filtro baseadas em colunas
• filter.sortSpecs: Especificações de classificação

Armadilhas:

• GOOGLESHEETS_LOOKUP_SPREADSHEET_ROW corresponde ao conteúdo inteiro da célula, não a substrings

…