Excel no n8n: leia e grave planilhas do Microsoft 365
Prepare o arquivo .xlsx, registre o app no Microsoft Entra, crie a credencial, leia poucas linhas, grave com Append ou Append or Update e veja como disparar o fluxo.
Por Redação Eleven Host · @robson.direitodigital · 17 de novembro de 2026 · 8 min de leitura

Capa da Redação Eleven Host para o tutorial: Excel no n8n: leia e grave planilhas do Microsoft 365 Arte: Eleven Host
Usar excel no n8n é ler e gravar planilhas .xlsx guardadas no OneDrive for Business ou no SharePoint: o nó Microsoft Excel (OneDrive) lê linhas, acrescenta registros e atualiza dados dentro de um fluxo.
Segundo a Microsoft, o Excel do Microsoft Graph não tem suporte para OneDrive pessoal: o arquivo precisa estar no OneDrive for Business ou no SharePoint, em conta Microsoft 365 empresarial ou escolar.
Atualizado em 17/11/2026. Em 17/11/2026, a versão estável do n8n é a 2.48.4, publicada em 13/11/2026, e o nó novo já nasce na versão 2.3.
O que é o nó Microsoft Excel (OneDrive)
No editor do n8n, o nome do nó é Microsoft Excel (OneDrive), e não "Microsoft Excel 365". Ele consome a API do Excel para pastas de trabalho guardadas no OneDrive da nuvem Microsoft 365. Para planilhas dentro de bibliotecas do SharePoint, existe um nó separado, o Microsoft Excel (SharePoint).
No campo Resource do nó, o padrão é Workbook, e as opções são Table, Workbook e Sheet. Em Workbook, as operações são Add Sheet, Delete e Get Many. Em Table, há Append, Convert to Range, Create, Delete, Get Columns, Get Rows e Lookup. Em Sheet, há Append, Append or Update, Clear, Delete, Get Many, Get Rows e Update.
O arquivo tem de ser .xlsx: o Microsoft Graph aceita só o formato Office Open XML, e planilhas .xls não são suportadas.
Para quem serve
Serve para a empresa que mantém dados em planilhas do Microsoft 365 e roda o n8n na própria VPS: registrar contatos de um formulário, atualizar o status de pedidos ou consultar uma lista de preços. Para o básico de servidor, há o artigo sobre servidor VPS.
Quem tem apenas um arquivo .xlsx solto, sem Microsoft 365, não usa este nó. O próprio nó indica os nós Extract from File e Convert to File para mexer direto em arquivos de planilha, sem conta Microsoft.
VPS vendida em seis planos, do Bronze ao Titanium. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Abrir a loja
Passo 1: preparar o arquivo
Abra o .xlsx no OneDrive for Business ou no SharePoint. O que o arquivo precisa ter depende do recurso que você vai usar.
- Para as operações de Table, a aba precisa ter uma tabela do Excel. Se ela não existir, a operação Table > Create cria uma a partir de um intervalo.
- Para as operações de Sheet, não é preciso tabela, mas a primeira linha do intervalo deve ter os nomes das colunas.
Confira os nomes das colunas, porque o n8n os usa como chaves dos dados.
Passo 2: criar a credencial e registrar o app no Microsoft Entra
No n8n Cloud, a credencial só pede um clique em Connect my account, sem registrar app. Em uma instância própria, o registro é manual, e a ordem abaixo evita voltar atrás.
- No n8n, abra uma credencial nova do tipo Microsoft Excel OAuth2 API e copie a URL de retorno (callback) do OAuth que ela mostra. Deixe a janela aberta.
- No portal do Microsoft Entra (Azure), escolha Register an application. Como tipo de conta, o n8n indica a opção multilocatário que também inclui contas pessoais da Microsoft.
- Em Redirect URI, escolha a plataforma Web e cole a URL copiada no item 1 desta lista.
- Na página do app, copie o Application (client) ID e cole no campo Client ID da credencial.
- Em Certificates & secrets, clique em + New client secret. Copie o Value e cole em Client Secret.
- De volta ao n8n, clique em Connect my account e entre com a conta Microsoft 365 da empresa.
Os escopos padrão da credencial são openid offline_access Files.ReadWrite. Há uma opção de escopos personalizados, mas o próprio n8n avisa que, se você os mudar, o nó pode parar de funcionar.
Consentimento do administrador
Em conta corporativa, o login só conclui se a política da empresa permitir que o usuário consinta com aplicativos que acessam dados da empresa em seu nome. Se não permitir, um administrador precisa aprovar o app. Isso depende da política de cada empresa.
Passo 3: ler a planilha com poucos dados
Crie um fluxo com gatilho manual e um nó Microsoft Excel (OneDrive) novo. Em Authentication, o padrão é Excel OAuth2. Escolha Resource em Sheet e Operation em Get Rows, e selecione o arquivo e a aba.
Ative Select a Range e informe uma faixa pequena em Range, como A1:D10. Com o campo em branco, o nó devolve a aba inteira. A Microsoft recomenda ler e gravar em faixas menores quando a área é grande, e uma faixa sem limite, como A:B, não pode ser gravada.
Em Header Row, o padrão é 0, o índice da linha com os nomes das colunas, e em First Data Row o padrão é 1. Os índices contam a partir do início do Range. Execute o nó e confira se as linhas aparecem com os nomes das colunas como chaves.
Passo 4: gravar linhas
Para uma tabela do Excel, use Table > Append, que adiciona linhas ao fim da tabela. Em Data Mode, o padrão é Map Each Column Below: você preenche Values to Send com pares de Column e Value. A opção Auto-Map Input Data to Columns serve quando os campos de entrada têm os mesmos nomes das colunas de destino.
Para uma aba sem tabela, use Sheet > Append, ou Sheet > Append or Update, que acrescenta uma linha nova ou atualiza a existente (upsert). Nesta última, a primeira linha do intervalo tem de trazer os nomes das colunas.
Escolha bem a coluna de comparação
Em Column to match on, a coluna serve para achar a linha a atualizar e não é alterada. Escolha uma com valor único, como o número do pedido, e informe o valor em Value of Column to Match On. Por padrão, Update All Matches fica desligado: só a primeira linha que casar é atualizada.
Planilha no SharePoint
Se o arquivo está numa biblioteca do SharePoint, use o nó Microsoft Excel (SharePoint), que tem os recursos Sheet, Table e Workbook. Ele aceita a credencial Microsoft OAuth2 (Graph) e a Microsoft Entra Service Principal, e o próprio nó dá Sites.ReadWrite.All como exemplo de escopo a habilitar.
A Service Principal é um acesso só do aplicativo, sem usuário logado. Ela funciona apenas em tenant Microsoft 365 de organização, usa permissões do tipo Application e exige consentimento de administrador; sem ele, o token vem sem permissões e a chamada dá erro 403. Para uma empresa pequena, recomendamos a credencial de usuário, e a Service Principal só quando houver um administrador e a necessidade de um fluxo sem pessoa logada.
Como disparar o fluxo
Não existe gatilho de Excel no n8n, então não há gatilho pronto para "linha nova na planilha". As saídas são usar outro gatilho, como um formulário, um Webhook ou uma agenda, ou o Microsoft OneDrive Trigger, que tem os eventos File Created (o padrão), File Updated, Folder Created e Folder Updated. Ele avisa que o arquivo mudou, mas não diz qual linha foi alterada.
Combinações para começar
Um exemplo: formulário vira linha na tabela. Um Form Trigger recebe nome, e-mail e telefone, e Table > Append grava os campos em Map Each Column Below. Para guardar o mesmo cadastro em outra ferramenta, veja Airtable no n8n: automatize bases e tabelas. Confira o resultado no seu arquivo.
Um exemplo: pedidos do dia numa planilha. Um Schedule Trigger roda no fim do expediente, um HTTP Request busca os pedidos, e Sheet > Append or Update usa o número do pedido em Column to match on, para atualizar o status sem duplicar a linha. Confira no seu arquivo antes de usar de verdade.
Um exemplo: lista de preços que abastece outro sistema. Um Schedule Trigger chama Table > Lookup, que procura linhas com um valor numa coluna, ou Sheet > Get Rows, e o resultado segue para um e-mail ou para outro sistema. Para guardar dados em um banco, veja Supabase no n8n: leia e grave dados nas tabelas.
Problemas comuns
- Conta pessoal: segundo a Microsoft, o Excel do Graph não tem suporte para OneDrive pessoal; mova o arquivo para a conta empresarial;
- Arquivo .xls: o formato não é suportado, salve como .xlsx;
- Login não conclui: a política da empresa pode exigir aprovação de um administrador;
- Erro com faixa grande: use uma faixa menor em Range;
- Sessão vencida (404): a sessão persistente expira após cerca de 5 minutos parada;
- Atualização na linha errada: se a coluna de Column to match on repete valores, só a primeira linha que casar é atualizada;
- Nó "Excel 365" não aparece: procure por Microsoft Excel (OneDrive).
Onde o n8n fica no ar
O n8n precisa estar de pé para executar os fluxos que gravam na planilha, e a VPS própria é uma das formas de mantê-lo no ar.
Quem quiser olhar as VPS da Eleven Host encontra os planos na loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver planos
Perguntas frequentes
O nó do n8n funciona com Excel do OneDrive pessoal?
Não. O Excel do Microsoft Graph só tem suporte para arquivos no OneDrive for Business, em sites do SharePoint ou em drives de grupo.
Existe um gatilho de Excel no n8n?
Não. Use outro gatilho ou o Microsoft OneDrive Trigger, que avisa quando um arquivo é criado ou alterado, sem dizer qual linha mudou.
O nó lê arquivos .xls?
Não pelo Microsoft Graph, que aceita só .xlsx. Para arquivos soltos, o nó indica Extract from File e Convert to File.
Qual operação evita linhas duplicadas?
Sheet > Append or Update, com uma coluna de valor único em Column to match on.