Google Calendar no n8n: criar e ler eventos
Crie a credencial OAuth2 do Google, crie e leia eventos no nó Google Calendar, use o gatilho, acerte o fuso horário e saiba o que fazer quando o token expira.
Por Redação Eleven Host · @robson.direitodigital · 15 de novembro de 2026 · 9 min de leitura

Capa da Redação Eleven Host para o tutorial: Google Calendar no n8n: criar e ler eventos Arte: Eleven Host
Usar o google calendar no n8n permite criar, ler, atualizar e apagar eventos de uma agenda dentro de um fluxo, e iniciar fluxos a partir de eventos da agenda. Na instalação própria, o n8n precisa de uma credencial OAuth2 criada por você no Google Cloud Console.
Atualizado em 15/11/2026. Em 15/11/2026, a versão estável do n8n na página de lançamentos do projeto é a 2.47.7, publicada em 13/11/2026. Na interface do n8n, campos e menus aparecem em inglês.
O que o nó Google Calendar faz
Segundo a documentação do n8n, o nó tem duas famílias de operações. Em Calendar, a operação Availability verifica se um horário está livre numa agenda. Em Event, as operações são Create, Delete, Get, Get Many e Update:
- Create: adiciona um evento ao calendário;
- Delete: apaga um evento;
- Get: busca um evento;
- Get Many: busca os eventos de um calendário;
- Update: atualiza um evento.
Além do nó de ação, existe o Google Calendar Trigger, que inicia um fluxo quando algo acontece na agenda.
Para quem serve
Interessa a quem já roda o n8n na própria VPS, com um domínio apontado para ele e HTTPS ativo. Se o domínio ainda não existe, veja como funciona o registro de domínio. Se a VPS ainda não existe, veja o que é um servidor VPS e como escolher um plano.
Para uma pequena empresa, agenda dentro de um fluxo serve para registrar agendamentos e lembrar a equipe de compromissos; mais adiante há dois exemplos.
Contratação de VPS em reais, pela loja. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Ver as VPS
Pré-requisito: domínio e HTTPS
A documentação do Google sobre endereços de retorno (redirect URIs) traz regras que importam aqui. Os endereços devem usar HTTPS, não HTTP simples. Hosts não podem ser endereços IP puros. O domínio de topo deve constar na lista de sufixos públicos. O localhost é exceção às duas primeiras regras.
Na prática, a instância precisa de um domínio com HTTPS para a credencial funcionar; só o IP do servidor, ou http, não serve.
Sobre o domínio em si: para domínios registrados na Eleven Host, há DNS gerenciado grátis na rede da Cloudflare (painel na área do cliente). O HTTPS, por sua vez, depende da configuração da sua instância.
Criar a credencial OAuth2 no Google
A documentação do n8n informa que a credencial gerenciada (Managed OAuth2) não está disponível no self-hosted, então a instalação própria usa uma credencial OAuth2 configurada por você. Os passos seguem a documentação do n8n, adaptados para o Google Calendar.
- No Google Cloud Console, abra o menu de projetos, clique em New project, informe nome e local e clique em Create;
- Em APIs & Services > Library, procure e ative a Google Calendar API;
- Em APIs & Services > OAuth consent screen, clique em Get started e informe o nome do app e o e-mail de suporte;
- Escolha o público do app (explicado a seguir);
- Em Branding, adicione o domínio da instância em Authorized domains e salve;
- Em Credentials, clique em + Create credentials > OAuth client ID e escolha o tipo Web application;
- No n8n, crie a credencial do Google Calendar e copie a OAuth Redirect URL que ele mostra. Cole o valor em Authorized redirect URIs no Google. A documentação pede que a cópia seja exata, com protocolo e porta;
- Copie o Client ID e o Client Secret do Google para o n8n e clique em Sign in with Google. Salve.
Confira se a OAuth Redirect URL mostrada no n8n começa com o endereço https do seu domínio. Se aparecer localhost ou http, revise a configuração de URL pública e de proxy da instância antes de colar o valor no Google.
Internal ou External: o público do app
Na tela de consentimento, a documentação descreve duas opções. Internal vale para usuários de uma organização Google Workspace. External aceita qualquer conta Google, mas o app começa em modo de teste (Testing). Nesse modo, só conseguem concluir o login os usuários cadastrados em Test users, na página Audience.
Com o app em modo de teste, a conexão cai a cada 7 dias. Decida antes como vai lidar com isso: reconectar a credencial, usar o público Internal ou publicar o app.
O token que expira em 7 dias
O Google informa que um app com público External e status Testing recebe um refresh token que expira em 7 dias. A documentação do n8n confirma o efeito: consentimento e tokens expiram após sete dias.
As saídas citadas nas documentações são estas:
- Reconectar: abrir a credencial no n8n e entrar com o Google de novo. É a solução que a documentação do n8n indica;
- Usar Internal: quando a conta pertence a um Google Workspace, o público Internal é uma alternativa ao External;
- Publicar o app: sujeito à verificação do Google para escopos sensíveis.
Sobre a verificação, a página do Google diz que escopos sensíveis exigem revisão antes de qualquer conta conceder acesso, e cita a leitura de eventos do Google Calendar como exemplo de escopo sensível. A mesma página lista exceções: uso por poucas pessoas ou só pelo próprio dono, uso apenas dentro de uma organização Google Workspace ou Cloud Identity, e a fase de teste.
Criar um evento
Com a credencial pronta, adicione o nó Google Calendar, escolha o recurso Event e a operação Create. Estes são os campos, com os nomes que a interface mostra:
- "Calendar": a agenda onde o evento será criado;
- "Start Time" e "End Time": início e fim do evento;
- "Use Default Reminders": usa os lembretes padrão da agenda.
O resto fica na lista de opções. O título do evento é o campo "Summary", que fica em opções e não no parâmetro principal. Entre as demais opções estão "Description" (descrição), "Location" (local), "Attendees" (convidados), "All Day" (dia inteiro), "Conference Data" (anexa um link de videochamada), "Send Updates" (define se os convidados recebem notificação) e "RRULE" (regra de recorrência).
Um exemplo: um formulário de contato envia nome, data e horários de início e de fim de uma visita por um webhook. O nó Google Calendar, em Event > Create, recebe esses dados em "Start Time" e "End Time" e usa o nome do cliente em "Summary". Monte o fluxo na sua instância e confira no Google Calendar se o evento aparece como esperado.
Ler eventos e ver horários livres
Para ler, use Event > Get Many. Os parâmetros incluem "Calendar", "Return All", "Limit", "After" e "Before". As opções incluem "Query" (busca por texto), "Order By", "Timezone" e "Fields", entre outras.
Na operação Update, "Update Fields" traz "Start", "End", "Summary", "Attendees" e outros. Em "Attendees", a documentação indica que dá para acrescentar convidados ou substituir a lista.
Para saber se um horário está livre, use o recurso Calendar com a operação Availability.
Um exemplo de lembrete: um fluxo agendado usa Get Many com "After" e "Before" para listar os eventos de um intervalo e envia um aviso para a equipe. O artigo ntfy na VPS: notificações push do seu servidor mostra como receber notificações push do seu servidor, e o artigo Windmill na VPS: automações e scripts da equipe apresenta outra ferramenta de automação. Confira o resultado no seu servidor antes de usar com clientes.
Google Calendar Trigger
O gatilho oferece cinco eventos: "Event Cancelled", "Event Created", "Event Ended", "Event Started" e "Event Updated". Ele verifica a agenda de tempos em tempos, então um fluxo pode começar depois do evento. Não conte com disparo no instante da mudança.
Fuso horário
Segundo a documentação do n8n, o fuso padrão é America/New_York. Para mudar o padrão da instância, defina a variável GENERIC_TIMEZONE com o valor desejado. A documentação usa Europe/Berlin como exemplo; para horário de Brasília, o valor seria America/Sao_Paulo. Um exemplo de linha para o ambiente do contêiner:
GENERIC_TIMEZONE=America/Sao_Paulo
Confira no seu servidor onde essa variável deve ficar, conforme a forma como você instalou o n8n. O fuso também pode ser definido nas configurações de cada workflow. A documentação avisa que, sem configurar nem o workflow nem a instância, o n8n usa o horário de Nova York (EDT). Get e Get Many têm a opção "Timezone". Para um horário informado sem fuso, teste com um evento de exemplo e veja o horário que o Google Calendar mostra.
URL pública atrás de proxy
Sem configuração manual, o n8n monta a URL de webhook com N8N_PROTOCOL, N8N_HOST e N8N_PORT. Atrás de um proxy reverso isso falha, porque o n8n escuta na porta 5678 e o proxy atende na 443.
Alguns tutoriais antigos mandam usar WEBHOOK_URL. Segundo a documentação, a variável N8N_WEBHOOK_URL está disponível desde a versão 2.30.0 e substitui a anterior. A WEBHOOK_URL está depreciada desde a 2.35.0. O exemplo da documentação é N8N_WEBHOOK_URL=https://n8n.example.com/ junto com N8N_PROXY_HOPS=1, e a documentação indica repassar, no último proxy, os cabeçalhos X-Forwarded-For, X-Forwarded-Host e X-Forwarded-Proto.
Cotas da API
Em 15/11/2026, a página de cotas do Google Calendar API informa estes limites por projeto: 10.000 requisições por minuto, 600 por minuto por usuário e 1.000.000 por dia. O uso padrão da API está disponível sem custo adicional. A mesma página informa que está prevista cobrança na conta de faturamento do Google Cloud para quem exceder os limites, mais adiante em 2026. Ao atingir o limite, a API responde com 403 usageLimits ou 429 usageLimits.
Onde conferir a documentação
As páginas de referência ficam em docs.n8n.io, para o nó e para as credenciais, e em developers.google.com, para OAuth e cotas.
Compra de VPS com cobrança mensal em reais. VPS a partir de R$ 29,90/mês no Plano Bronze; confira na loja o que cada plano inclui. Conhecer as VPS
Perguntas frequentes
Posso usar o IP da VPS em vez de um domínio?
Não para este login. O Google exige HTTPS nos endereços de retorno e não aceita endereços IP puros, com exceção do localhost.
Qual variável define a URL de webhook?
A N8N_WEBHOOK_URL, desde a versão 2.30.0.
O gatilho dispara na hora em que o evento muda?
Não conte com isso. O gatilho verifica a agenda de tempos em tempos, então pode haver atraso entre a mudança e o início do fluxo.