Automação com Excel

Automatize operações de planilhas, incluindo a criação de pastas de trabalho, escrita de dados, formatação de células, upsert de linhas e gerenciamento de planilhas. Funciona com Microsoft Excel (OneDrive) e Google Sheets.

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

Configuração

Esta habilidade requer o servidor Rube MCP conectado em https://rube.app/mcp.

Antes de executar qualquer ferramenta, certifique-se de que existe uma conexão ativa para o toolkit excel (e opcionalmente googlesheets). Se nenhuma conexão estiver ativa, inicie uma através de RUBE_MANAGE_CONNECTIONS.

Fluxos de Trabalho Principais

1. Criar uma Nova Pasta de Trabalho do Excel

Use EXCEL_CREATE_WORKBOOK para gerar um novo arquivo .xlsx e enviá-lo para o OneDrive.

Ferramenta: EXCEL_CREATE_WORKBOOK

Etapas:

1. Chame EXCEL_CREATE_WORKBOOK com nomes de planilhas e dados
2. A ferramenta cria um arquivo .xlsx e o envia para o OneDrive
3. Use o caminho/URL do arquivo retornado para operações subsequentes

2. Escrever Dados em uma Planilha

Use GOOGLESHEETS_BATCH_UPDATE para escrever valores em um intervalo específico ou adicionar linhas.

Ferramenta: GOOGLESHEETS_BATCH_UPDATE

Parâmetros Principais:

• spreadsheet_id (obrigatório) -- O ID da planilha da URL (string alfanumérica de 44 caracteres)
• sheet_name (obrigatório) -- Nome da aba, por exemplo, "Sheet1", "Sales Data"
• values (obrigatório) -- Matriz 2D de valores de células, por exemplo, [["Name","Amount"],["Alice",100]]
• first_cell_location -- Célula inicial em notação A1 (por exemplo, "A1", "D3"). Omitir para adicionar linhas
• valueInputOption -- "USER_ENTERED" (padrão, analisa fórmulas) ou "RAW" (armazena como está)

Exemplo:

Tool: GOOGLESHEETS_BATCH_UPDATE
Arguments:
  spreadsheet_id: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
  sheet_name: "Sheet1"
  values: [["Item","Cost","Stocked"],["Wheel",20.50,true],["Screw",0.50,true]]
  first_cell_location: "A1"

3. Atualizar (Upsert) Linhas por Coluna Chave

Use GOOGLESHEETS_UPSERT_ROWS para atualizar linhas existentes correspondendo a uma coluna chave, ou adicionar novas linhas se nenhuma correspondência for encontrada. Ideal para sincronizações de CRM, atualizações de inventário e deduplicação.

Ferramenta: GOOGLESHEETS_UPSERT_ROWS

Parâmetros Principais:

• spreadsheetId (obrigatório) -- O ID da planilha
• sheetName (obrigatório) -- Nome da aba
• rows (obrigatório) -- Matriz 2D de linhas de dados (mínimo 1 linha). Se headers for omitido, a primeira linha é tratada como cabeçalhos
• headers -- Nomes das colunas para os dados, por exemplo, ["Email","Phone","Status"]
• keyColumn -- Cabeçalho da coluna para corresponder, por exemplo, "Email", "SKU", "Lead ID"
• strictMode -- true (padrão) gera erro em colunas incompatíveis; false trunca silenciosamente

Exemplo:

Tool: GOOGLESHEETS_UPSERT_ROWS
Arguments:
  spreadsheetId: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
  sheetName: "Contacts"
  keyColumn: "Email"
  headers: ["Email","Phone","Status"]
  rows: [["john@example.com","555-0101","Active"],["jane@example.com","555-0102","Pending"]]

4. Formatar Células

Use GOOGLESHEETS_FORMAT_CELL para aplicar negrito, itálico, tamanho da fonte e cores de fundo a intervalos.

Ferramenta: GOOGLESHEETS_FORMAT_CELL

Parâmetros Principais:

• spreadsheet_id (obrigatório) -- O ID da planilha
• range -- Intervalo de células em notação A1, por exemplo, "A1:D1", "B2:B10" (recomendado em vez de baseado em índice)
• sheet_name -- Nome da planilha, por exemplo, "Sheet1"
• bold -- true/false
• italic -- true/false
• fontSize -- Tamanho da fonte em pontos, por exemplo, 12
• red, green, blue -- Componentes de cor de fundo (escala de float de 0.0 a 1.0, NÃO 0 a 255)

Exemplo (linha de cabeçalho em negrito com fundo azul):

Tool: GOOGLESHEETS_FORMAT_CELL
Arguments:
  spreadsheet_id: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
  range: "A1:D1"
  sheet_name: "Sheet1"
  bold: true
  fontSize: 12
  red: 0.2
  green: 0.4
  blue: 0.9

5. Adicionar Novas Abas de Planilha

Use GOOGLESHEETS_ADD_SHEET para criar novas abas dentro de uma planilha existente.

Ferramenta: GOOGLESHEETS_ADD_SHEET

Parâmetros Principais:

• spreadsheetId (obrigatório) -- O ID da planilha
• title -- Nome para a nova aba, por exemplo, "Q4 Report"
• forceUnique -- true (padrão) adiciona automaticamente um sufixo se o nome já existir

Exemplo:

Tool: GOOGLESHEETS_ADD_SHEET
Arguments:
  spreadsheetId: "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"
  title: "Q4 Report"
  forceUnique: true

6. Ler Dados e Verificar Conteúdo

Use GOOGLESHEETS_BATCH_GET para recuperar dados de intervalos de células especificados para validação ou processamento posterior.

Ferramenta: GOOGLESHEETS_BATCH_GET

Etapas:

…