Imagina poder falar para o Claude: "Agenda uma reunião com a Ana para a próxima terça às 15h e já manda o convite." Ou perguntar: "Tenho algum compromisso essa semana que conflita com uma viagem na sexta?" Isso é possível quando você conecta o Google Calendar ao Claude Code.
Este guia ensina o processo completo, do zero, para Windows e Mac — com opções para celular também.
O que o Claude consegue fazer com o Calendar
Com o Google Calendar conectado, o Claude passa a conseguir:
- Ver seus eventos e compromissos
- Criar novos eventos com título, hora, local e convidados
- Editar ou cancelar eventos existentes
- Verificar horários livres na sua agenda
- Sugerir o melhor horário para uma reunião
- Criar eventos recorrentes (tipo "toda segunda às 9h")
É como ter um secretário disponível o tempo todo — só que esse secretário é uma IA que não esquece nada.
O que você precisa antes de começar:
- Claude Code instalado (veja o guia de instalação)
- Conta Google com o Calendar ativado
- Node.js instalado
- Uns 20 minutos
Entendendo o processo
O fluxo é parecido com o do Google Drive:
- Você cria um projeto no Google Cloud (gratuito)
- Ativa a API do Google Calendar
- Baixa as credenciais de acesso
- Configura o Claude Code para usar essas credenciais
- O Claude passa a ter acesso à sua agenda
Se você já fez o guia do Google Drive, o processo de criar o projeto e baixar credenciais é idêntico — você pode reaproveitar o mesmo projeto e simplesmente ativar a API do Calendar também.
Parte 1 — Criar credenciais no Google Cloud
Esse processo funciona igual para Windows e Mac.
Passo 1 — Acesse o Google Cloud Console
- Vai para https://console.cloud.google.com
- Faz login com a conta Google que tem o Calendar
- Aceita os termos se for a primeira vez
Passo 2 — Crie ou selecione um projeto
Se você já fez o guia do Google Drive:
Seleciona o mesmo projeto que criou antes (tipo meu-claude-drive) e pula para o Passo 3.
Se é a primeira vez:
- Clica em "Selecionar projeto" no canto superior esquerdo
- Clica em "Novo projeto"
- Nome:
meu-assistente-ia(ou qualquer nome) - Clica em "Criar"
- Seleciona o projeto criado
Passo 3 — Ative a API do Google Calendar
- No menu lateral, vai em "APIs e serviços" → "Biblioteca"
- Pesquisa:
Google Calendar API - Clica no resultado "Google Calendar API"
- Clica em "Ativar"
- Aguarda a ativação
Passo 4 — Crie ou reutilize as credenciais OAuth
Se você já tem um arquivo credentials.json do guia do Drive:
Você pode usar o mesmo arquivo. Pula para a Parte 2.
Se ainda não tem:
- Vai em "APIs e serviços" → "Credenciais"
- Clica em "+ Criar credenciais" → "ID do cliente OAuth"
- Se pedir para configurar a tela de consentimento:
- Escolhe "Externo"
- Preenche o Nome do app:
Claude Agenda - Coloca seu e-mail de suporte
- Salva e continua em cada tela
- Na tela Usuários de teste, adiciona seu próprio e-mail
- Conclui
- Volta para "Credenciais" → "+ Criar credenciais" → "ID do cliente OAuth"
- Tipo de aplicativo: "App para computador"
- Nome:
Claude Code Calendar - Clica em "Criar"
- Clica em "Baixar JSON"
- Salva o arquivo como
credentials.jsonnum lugar seguro
Parte 2 — Configurar no Windows
Passo 5 — Instale o servidor MCP do Google Calendar
Abre o Prompt de Comando (Windows + R, digita cmd, Enter) e digita:
npm install -g @modelcontextprotocol/server-google-calendar
Aguarda a instalação.
Passo 6 — Configure o Claude Code
Abre o arquivo de configuração do Claude Code:
notepad %USERPROFILE%\.claude\settings.json
Se o arquivo já existir (por exemplo, porque você configurou o Drive), você precisa adicionar o novo servidor dentro do bloco mcpServers. O arquivo deve ficar assim (com ambos, Drive e Calendar, se você configurou os dois):
{
"mcpServers": {
"gdrive": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-gdrive"],
"env": {
"GDRIVE_CREDENTIALS_FILE": "C:\\Users\\SeuNome\\credentials.json"
}
},
"google-calendar": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-calendar"],
"env": {
"GOOGLE_CREDENTIALS_FILE": "C:\\Users\\SeuNome\\credentials.json"
}
}
}
}
Se você só quer o Calendar (sem o Drive), fica assim:
{
"mcpServers": {
"google-calendar": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-calendar"],
"env": {
"GOOGLE_CREDENTIALS_FILE": "C:\\Users\\SeuNome\\credentials.json"
}
}
}
}
Troca SeuNome pelo seu nome de usuário no Windows (descobre digitando echo %USERNAME% no cmd).
Salva o arquivo e fecha.
Passo 7 — Autorize o acesso à agenda
- Abre qualquer pasta no Explorador de Arquivos
- Clica na barra de endereço, digita
cmd, Enter - Digita
claude - Quando o Claude abrir, digita:
O que tenho na agenda hoje? - O navegador vai abrir pedindo permissão para acessar o Google Calendar
- Clica em "Permitir" (ou "Allow")
- Volta para o terminal — o Claude vai mostrar seus eventos do dia!
Parte 2 — Configurar no Mac
Passo 5 — Instale o servidor MCP
No Terminal:
npm install -g @modelcontextprotocol/server-google-calendar
Passo 6 — Configure o Claude Code
Abre o arquivo de configuração:
nano ~/.claude/settings.json
Adiciona o servidor do Calendar (ou cria o arquivo com este conteúdo):
{
"mcpServers": {
"google-calendar": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-calendar"],
"env": {
"GOOGLE_CREDENTIALS_FILE": "/Users/SeuNome/credentials.json"
}
}
}
}
Troca SeuNome pelo seu usuário (descobre com whoami no Terminal).
Para salvar no nano: Ctrl + X, Y, Enter.
Passo 7 — Autorize o acesso
- No Terminal, digita
claude - Pede para ver seus eventos:
O que tenho na agenda essa semana? - O navegador abre para autorização do Google Calendar — clica em "Permitir"
- Pronto!
Usando no Android e iPhone
Assim como o Drive, o servidor MCP do Calendar roda em computadores. Para celular, use as opções abaixo.
Opção A — Integrações nativas do Claude.ai
A Anthropic está lançando integrações diretas no site do Claude. Verifique se o Calendar já está disponível:
- Acessa https://claude.ai no navegador do celular
- Abre as configurações ou menu do perfil
- Procura por "Integrações" ou "Connections"
- Se aparecer o Google Calendar, conecta com sua conta Google
- Pronto — você pode pedir ao Claude para verificar e criar eventos
Opção B — Google Assistant + Claude
Enquanto as integrações nativas não chegam a todos, você pode usar o Google Assistant para gerenciar o Calendar e o Claude para planejar o que colocar nele. Não é a mesma coisa, mas funciona para muitos casos do dia a dia.
Exemplos práticos de uso
Depois de configurar tudo, o que você pode fazer:
Ver o dia de hoje:
> O que tenho na agenda hoje? Tem algum horário livre para almoço?
Criar um evento:
> Cria um evento "Reunião com fornecedor" para amanhã às 14h, com duração de 1 hora
Encontrar um horário livre:
> Preciso de 2 horas para trabalhar sem interrupção essa semana. Qual o melhor horário?
Criar evento recorrente:
> Cria um evento "Academia" toda segunda, quarta e sexta às 7h da manhã
Verificar conflitos:
> Tenho uma viagem sexta a partir das 12h. Algum evento conflita com isso?
Preparar para uma reunião:
> Tenho a reunião "Revisão de produto" às 15h. Me ajuda a criar uma pauta de 30 minutos
Dicas avançadas
Combinando Drive + Calendar
Se você conectou os dois serviços, o Claude se torna ainda mais poderoso. Exemplos:
> Tenho uma reunião "Revisão Trimestral" amanhã às 10h.
Encontra o documento "Relatório Q1" no meu Drive e me prepara um resumo dos pontos principais
> Cria um evento "Preparar proposta" para sexta às 9h e também cria um documento
no Drive chamado "Proposta Cliente X" com uma estrutura básica
Definindo o calendário padrão
Se você tem vários calendários no Google (pessoal, trabalho, etc.), pode especificar qual usar:
> Cria o evento no meu calendário de trabalho, não no pessoal
Dúvidas comuns
"Calendar API has not been used in project": Você precisa ativar a API. Volta ao Passo 3 e confirma que clicou em "Ativar" na página da Google Calendar API.
O evento foi criado mas não aparece no Calendar: Verifica se o Claude criou no calendário certo. Pergunta: "Em qual calendário você criou o evento?"
"Invalid grant" ou token expirado:
Deleta o arquivo de token salvo (geralmente em ~/.config/google-calendar-token.json no Mac ou %APPDATA%\google-calendar-token.json no Windows) e autoriza de novo.
Não quero dar acesso a toda a agenda: Cria um calendário separado no Google Calendar chamado "Claude" e pede para o assistente usar apenas esse calendário. Assim você controla exatamente o que ele vê e edita.
Com o Google Calendar conectado, o Claude deixa de ser apenas um assistente de texto e passa a ser parte da sua rotina. Ele sabe o que você tem para fazer, pode planejar junto com você e transforma sua agenda em algo inteligente — não apenas uma lista de compromissos.