Meu agente de IA tem acesso ao meu Gmail, Google Drive, Calendar, Sheets e Tasks. Ele lê emails, envia respostas, cria eventos, organiza arquivos e preenche planilhas — tudo por linguagem natural.
Não é uma integração limitada. São 33 APIs do Google Workspace expostas no terminal do meu servidor, prontas pra serem operadas pelo Claude Code. Ele pode fazer tudo que eu faria na interface web. A diferença é que eu peço em português e ele executa.
Como funciona
A ponte entre o Claude Code e o Google Workspace é uma CLI chamada gws — Google Workspace CLI. É open-source, mantida pelo time do Google, e funciona assim: ela lê as definições de API direto do Discovery Service do Google em tempo real. Qualquer endpoint que o Google expõe, o gws suporta automaticamente.
Instalei no servidor, autentiquei com OAuth uma vez, e criei uma skill — um arquivo markdown que ensina o Claude Code a usar cada API. É o mesmo conceito que descrevi no post sobre o cofre de cérebros com Obsidian: ensinar a IA a operar ferramentas de forma persistente.
Com a skill carregada, o Claude Code sabe a sintaxe exata de cada comando. Eu peço em linguagem natural, ele traduz pro comando certo, executa, parseia o JSON de retorno, e me responde como um humano faria.
O que ele faz no meu Gmail
Filtra e busca. Peço "o que chegou de importante hoje?" e ele lista os emails não lidos, agrupa por remetente, e resume o conteúdo. Peço "busca emails da AWS da última semana" e ele filtra por remetente e data.
gws gmail users messages list
--params '{"userId": "me", "q": "from:aws newer_than:7d"}'Lê mensagens. Não só os assuntos — ele baixa o conteúdo completo, incluindo anexos. Uma vez pedi pra buscar relatórios DMARC e ele baixou os XMLs compactados, descompactou, parseou, e me mostrou os IPs que estavam fazendo spoofing no meu domínio. Tudo sem eu abrir o Gmail.
Envia emails. Peço "manda um email pro Lucas com o relatório de ontem" e ele compõe a mensagem, codifica em base64url no formato RFC 2822, e envia pela API.
gws gmail users messages send
--params '{"userId": "me"}'
--body '{"raw": "<base64url-encoded-message>"}'Deleta e organiza. "Limpa os emails de newsletter que não abri no último mês." Ele busca, filtra, e move pro lixo.
O que ele faz no Calendar
Consulta a agenda. "O que tenho pra hoje?" — e ele me diz "2 reuniões, a primeira às 10h com cliente, a segunda às 16h pra review de PR."
gws calendar events list
--params '{"calendarId": "primary", "timeMin": "2026-03-20T00:00:00-03:00", "timeMax": "2026-03-20T23:59:59-03:00", "singleEvents": true, "orderBy": "startTime"}'Cria eventos. "Marca uma reunião amanhã às 14h pra revisar o deploy, 1 hora." Ele cria com timezone certo, duração, título.
Cancela e reagenda. "Move a reunião de amanhã pra sexta às 10h." Ele busca o evento, atualiza, confirma.
O que ele faz no Drive e Sheets
Busca arquivos. "Qual o último documento que editei?" — ele lista por data de modificação e me mostra.
gws drive files list
--params '{"pageSize": 5, "orderBy": "modifiedTime desc", "fields": "files(id,name,mimeType,modifiedTime)"}'Cria planilhas com dados. "Salva esses resultados numa planilha nova." Ele cria a spreadsheet e popula com os dados que eu passei.
gws sheets spreadsheets values update
--params '{"spreadsheetId": "abc123", "range": "A1", "valueInputOption": "USER_ENTERED"}'
--body '{"values": [["Métrica", "Valor"], ["Uptime", "99.8%"], ["Requests", "47k"]]}'Lê dados de planilhas existentes. "Puxa os dados da planilha de custos." JSON limpo de volta, que ele interpreta e resume.
O que ele faz no Tasks
Lista tarefas. "O que tenho pendente?" — ele consulta as task lists e me dá um resumo.
Cria tarefas. "Adiciona uma tarefa: revisar config do Nginx até sexta." Feito.
A skill que faz tudo funcionar
Sem a skill, o Claude Code teria que adivinhar a sintaxe de cada API a cada conversa. Com a skill, ele sabe exatamente qual comando rodar, quais parâmetros passar, e como interpretar a resposta.
A skill cobre: busca de emails, leitura de mensagens, envio (incluindo o encoding base64url), criação e consulta de eventos, listagem de arquivos, leitura e escrita em planilhas, gerenciamento de tarefas, e até introspecção de API com gws schema — um comando que permite ao agente descobrir sozinho qualquer método de qualquer API do Google.
Essa skill faz parte do meu repositório open-source claude-skills com 44+ skills. Se você já usa o Claude Code, é plug and play.
O preço da delegação
Preciso ser honesto: dar acesso total ao seu Google Workspace pra um agente de IA exige confiança na ferramenta. Eu uso scopes mínimos quando possível — gmail.readonly se só preciso ler, gmail.send quando preciso enviar. A autenticação OAuth significa que posso revogar o acesso a qualquer momento pelo painel do Google.
O token OAuth precisa de browser na primeira autenticação. No meu servidor headless, copiei a URL, autorizei no notebook, colei o código de volta. Fiz isso uma vez. O refresh token persiste por meses.
O padrão: dê acesso, crie a skill, delegue
É o mesmo padrão que uso pra conectar o Meta Ads ao Claude Code:
- Encontre a ferramenta que exponha o serviço via terminal
- Crie a skill que ensine o agente a usá-la
- Delegue e interaja por conversa
O Google Workspace é o caso mais transformador porque é onde vive a rotina de qualquer pessoa — email, agenda, documentos, planilhas. Quando seu agente tem acesso a tudo isso, ele deixa de ser uma ferramenta que você usa e passa a ser um assistente que opera junto com você.
A parte mais surpreendente não é a tecnologia. É como rápido você esquece que existia outra forma de checar email.
