CLI do Google Workspace: Automatize Gmail, Drive e Agenda Pelo Terminal

Todo dia, milhões de pessoas jogam o mesmo jogo ineficiente: abrir o Gmail, clicar por aqui, abrir o Drive em outra aba, pesquisar um arquivo, ir para a Agenda, colar algo num Documento. É aceitável — mas também são milhares de pequenos cliques que somam horas que você nunca vai recuperar.

Algo mudou no início de março de 2026. O Google lançou silenciosamente uma ferramenta que permite falar com tudo isso — Gmail, Drive, Agenda, Planilhas, Documentos, Chat — a partir de uma única linha no seu terminal. Ela se chama gws, e chegou ao #1 do Hacker News com mais de 500 pontos e 22.000 estrelas no GitHub em sua primeira semana.

Isso não é apenas para desenvolvedores. Se você já desejou que o Google Workspace simplesmente fizesse algo por você — e está disposto a gastar 20 minutos configurando — este é o seu ponto de partida.

⚠️ Atenção: O gws está em pré-v1 e não tem suporte oficial do Google. É código aberto (Apache 2.0). Ótimo para automação pessoal e experimentos — não recomendado para produção sem testes rigorosos primeiro.

O Que é o CLI do Google Workspace?

Pense no gws como um controle remoto universal para todo o seu Google Workspace. Em vez de navegar entre cinco aplicativos diferentes no navegador, você digita um comando e recebe um resultado instantâneo e estruturado. Sem telas de carregamento. Sem clicar. Sem trocar de aba.

O que o torna genuinamente inteligente: em vez de enviar uma lista fixa de comandos, ele lê o próprio Serviço de Descoberta do Google em tempo de execução e constrói sua superfície de comandos dinamicamente. Isso significa que quando o Google adiciona um novo endpoint de API, o gws o detecta automaticamente — sem necessidade de atualização do pacote. Cada resposta vem como JSON estruturado, que funciona perfeitamente com agentes de IA, scripts de shell e qualquer outra coisa que leia dados limpos.

Como Usuários Avançados Estão Realmente Usando

O resumo da caixa de entrada segunda de manhã

O caso de uso mais citado desde o lançamento. Em vez de abrir o Gmail e se afogar em e-mails não lidos, os usuários estão conectando um agente de IA — Claude Code, Gemini CLI ou qualquer coisa que possa executar comandos de terminal — para processar a caixa de entrada automaticamente:

Prompt para seu agente de IA: Leia meus últimos 10 e-mails. Para cada um, decida se é urgente, precisa de ação ou é apenas informativo. Em seguida, crie uma apresentação do Google Slides chamada "Briefing Executivo", um Documento Google chamado "Notas do Briefing Semanal" e registre todos os 10 numa planilha do Google com colunas para remetente, prioridade, prazo e item de ação.

Antes do gws, isso era um fluxo de trabalho no Zapier, três APIs separadas e um fim de semana de depuração. Agora é um prompt para um agente que já tem acesso a tudo.

Fluxos de trabalho de contratos e documentos

Um agente lê um novo e-mail de contrato, extrai os termos principais para um Documento Google compartilhado, arquiva os anexos no Drive, notifica a equipe jurídica no Chat e sinaliza o prazo de revisão na Agenda — tudo acionado por um único e-mail recebido. Esse tipo de automação multi-etapas e entre aplicativos só era possível anteriormente com código de API personalizado ou plataformas sem código caras.

Substituindo o Zapier para fluxos nativos do Workspace

Para fluxos de trabalho que vivem inteiramente dentro do Google Workspace, o gws pode substituir ferramentas de automação pagas. Sem preços por operação, sem construtor de fluxo de trabalho para aprender, sem dependência de plataforma. Membros da comunidade relatam substituir planos do Zapier de R$250 a R$500/mês para suas automações do Workspace.

⚡ Limitação importante: O gws é de Google para Google. Se seu fluxo de trabalho precisa do Salesforce, HubSpot ou Slack, você ainda precisará do Zapier ou n8n para essas conexões. Mas para fluxos de trabalho que ficam dentro do Workspace, isso cobre a camada de automação pela qual você estava pagando mensalmente.

Configuração em 4 Passos

Passo 1 — Instale o Node.js e depois instale o gws

Verifique se você tem o Node digitando node --version no seu terminal. Se não, baixe em nodejs.org. Depois execute:

npm install -g @googleworkspace/cli

# Verifique se instalou corretamente
gws --version

Passo 2 — Crie um projeto no Google Cloud

Vá para console.cloud.google.com, crie um novo projeto (qualquer nome), depois navegue até APIs e Serviços → Credenciais → Criar ID do cliente OAuth 2.0 e selecione Aplicativo de desktop. Baixe o arquivo JSON — essa é sua chave.

Se você já tem o CLI gcloud instalado, ignore tudo isso e basta executar gws auth setup — ele cuida de toda a configuração do projeto Cloud automaticamente.

Passo 3 — Autentique-se

gws auth login
# O navegador abre → aprove o acesso → pronto
# As credenciais são criptografadas e armazenadas no chaveiro do SO

⚠️ Contas Gmail em modo de teste: O Google limita aplicativos não verificados a aproximadamente 25 escopos OAuth. Quando você vir o seletor de escopos, escolha serviços individuais (apenas Gmail ou apenas Drive) em vez de "selecionar tudo" para evitar atingir esse limite.

Passo 4 — Habilite a API e execute seu primeiro comando

Habilite a API específica (Drive, Gmail, etc.) para seu projeto no painel do Console do Cloud, depois tente seu primeiro comando:

# Listar seus arquivos do Google Drive
gws drive files list

# Limitar aos 10 primeiros resultados
gws drive files list --params '{"pageSize": 10}'

# Verificar próximos eventos da agenda
gws calendar events list --params '{"calendarId":"primary","maxResults":5}'

# Explorar todos os comandos disponíveis para um serviço
gws gmail --help

Programe Sua Primeira Automação com Vibe Coding

Você não precisa escrever scripts do zero. Descreva o que você quer em linguagem simples, cole no Claude, ChatGPT ou Gemini e receba código funcional em minutos. Aqui estão três prompts prontos para usar.

Template 1 — Resumo de e-mails matinal

Escreva um script bash que usa o CLI do Google Workspace (gws) para buscar
meus últimos 20 e-mails não lidos do Gmail como JSON, resume cada um usando
o Claude e salva o resultado como morning-brief.md no meu diretório home.
Inclua remetente, assunto e um resumo de uma frase por e-mail.

Template 2 — Arquivar automaticamente anexos no Drive

Escreva um script Python que usa o gws (via subprocess) para pesquisar no Gmail
e-mails com anexos em PDF dos últimos 7 dias, baixa cada anexo
e faz upload para uma pasta do Google Drive chamada
"Anexos da Caixa de Entrada" usando gws drive files create com a flag --upload.

Template 3 — Relatório semanal no Planilhas (pronto para cron)

Escreva um script bash que posso executar via cron toda sexta-feira às 17h.
Ele deve usar o gws para acrescentar uma linha a uma planilha do Google
(ID: SEU_ID_AQUI) com a data de hoje, o número de e-mails que recebi esta
semana (de gws gmail) e o número de eventos de agenda que tive (de gws calendar).

💡 Segredo para bons resultados: Sempre informe ao seu agente de IA (1) qual serviço gws você está usando, (2) que as saídas são JSON e (3) exatamente qual deve ser o resultado final — um arquivo, um e-mail, uma linha no Planilhas. Quanto mais específico sobre o estado final, mais limpo será o código que você receberá.

Qual Tipo de Usuário Avançado Você É?

Ressalvas Honestas Antes de Mergulhar

Está em pré-v1. Comandos, flags e formatos de saída podem mudar entre versões. Se você está construindo algo importante, fixe em uma versão específica: npm install -g @googleworkspace/cli@x.x.x.

A configuração leva de 20 a 30 minutos. A etapa do projeto do Google Cloud é o principal ponto de atrito. Use gws auth setup se você tem o gcloud — ele automatiza a maior parte.

Limites de escopo afetam contas Gmail pessoais. No modo de teste, o Google limita aplicativos não verificados a aproximadamente 25 escopos OAuth. Selecione serviços individuais no seletor de escopos, não "todos".

Não é uma ferramenta multiplataforma. O gws cobre tudo dentro do ecossistema do Google. Para fluxos de trabalho que tocam ferramentas externas como Slack ou Salesforce, você ainda precisará de uma camada de conector.

Comece Hoje

Um comando para instalar. Um fim de semana para automatizar aquela coisa que tem te incomodado há meses.

• 🐙 Repositório no GitHub
• 📦 Pacote no npm
• 📖 Documentação de Habilidades do Agente

npm install -g @googleworkspace/cli

Prefere Sem Código? Experimente os Complementos 8apps

Se comandos de terminal não são sua praia, você ainda pode automatizar o Google Workspace usando nossos complementos prontos para uso. Eles funcionam nativamente dentro do Gmail, Planilhas e Drive sem configuração complexa:

• Contact Extractor: Construa instantaneamente sua lista de vendas extraindo nomes, e-mails e números de telefone do Gmail para o Google Planilhas.
• Currency Converter: Converta facilmente valores de câmbio ao vivo diretamente nas suas planilhas do Google.
• Drive Guard: Audite e gerencie permissões de arquivos com segurança em todo o seu Google Drive.
• GPT Mate: Redija e-mails e conteúdo automaticamente trazendo o ChatGPT e o Gemini diretamente para o Google Documentos e Planilhas.
• Hash Data: Proteja informações sensíveis e dados pessoais hasheando dados rapidamente no Google Planilhas.
• Mail My Sheets: Automatize seus relatórios enviando por e-mail snapshots das suas planilhas num agendamento.
• Mail to Drive: Mantenha registros seguros salvando automaticamente e-mails e anexos importantes como PDFs no Drive.

Tem um fluxo de trabalho personalizado em mente?
Podemos criar um complemento do Google Workspace sob medida para seus processos de negócio. Escreva para nós em support@8apps.co para começar!