Google Workspace CLI (invocado como gws) é uma ferramenta de linha de comando dinâmica e de código aberto que oferece a humanos e agentes de IA acesso unificado a Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin e a cada API do Google Workspace — construída diretamente do Serviço de Descoberta (Discovery Service) ao vivo do Google para que os comandos permaneçam atualizados sem a necessidade de atualizações. Instale o Google Workspace CLI globalmente via npm, autentique-se uma vez com OAuth e conecte-se a agentes como Claude Code ou Cursor com as habilidades incluídas. Não são necessários fluxos de OAuth padronizados ou SDKs separados.
O que é o Google Workspace CLI e por que ele é importante?Aqui está um problema que todo desenvolvedor, administrador e usuário de agente de IA enfrenta: você deseja automatizar ou consultar serviços do Google Workspace (arquivos do Drive, enviar Gmail, criar eventos do Calendar, adicionar a Sheets, editar Docs, postar no Chat), mas acaba escrevendo scripts curl personalizados, lutando com escopos de OAuth, lidando com paginação manualmente ou juntando múltiplos SDKs que se tornam obsoletos.
Isso acontece porque as APIs do Google Workspace são poderosas, mas fragmentadas — cada serviço tem seus próprios endpoints, fluxos de autenticação e peculiaridades. Ferramentas tradicionais forçam você a manter código boilerplate que quebra com as mudanças da API.
O Google Workspace CLI resolve isso. Lançado no início de 2026 pela equipe do Google (anunciado por Addy Osmani), é um CLI único, alimentado por Rust, que descobre dinamicamente cada método da API do Workspace em tempo de execução usando o Discovery Service do Google. Você obtém acesso instantâneo a novos endpoints sem esperar por atualizações da ferramenta.
O resultado: seus scripts, agentes e trabalho diário no terminal permanecem precisos e atualizados. O Google Workspace CLI gera JSON limpo, suporta dry-runs, auxiliares de paginação e inclui mais de 40 atalhos amigáveis (prefixados com +) como gws gmail +send ou gws calendar +agenda.
O Google Workspace CLI também vem com habilidades de agente prontas para instalar, para que ferramentas como Claude Code, Cursor, OpenClaw ou Gemini CLI possam gerenciar seu Workspace autonomamente — sem a necessidade de definições de ferramentas personalizadas.
Se você está construindo ou testando integrações de API junto com a automação do Workspace, o Apidog lida com o lado da verificação. É um cliente de API gratuito para enviar requisições, inspecionar respostas, gerenciar ambientes e executar conjuntos de testes. Juntos, o Google Workspace CLI fornece acesso em tempo real aos seus dados, e o Apidog confirma que cada chamada se comporta como esperado.
Instalando o Google Workspace CLIO único requisito é Node.js 18 ou posterior. Verifique sua versão com:
node --versionExecutar sem instalarA maneira mais rápida de experimentar o Google Workspace CLI é com npx (baixa a versão mais recente a cada vez):
npx @googleworkspace/cli --help
npx @googleworkspace/cli drive files list --params '{"pageSize":1}'Ótimo para testes rápidos ou scripts avulsos.
Instalar globalmentePara uso regular, instale globalmente para que o comando gws esteja sempre disponível:
npm install -g @googleworkspace/cli
gws --versionO Google Workspace CLI empacota binários pré-construídos, então a inicialização é rápida — não há necessidade de compilar Rust localmente. Você também pode obter os binários em GitHub Releases, usar o Homebrew (brew install googleworkspace/cli) ou executar via Nix, se preferir.
Configurando o Google Workspace CLI para seu agente de codificação de IAO comando gws auth setup lida com a criação de projetos, habilitação de APIs e OAuth inicial em um fluxo guiado. Execute:
gws auth setupEle abre seu navegador, cria um projeto Google Cloud, se necessário, habilita as APIs necessárias e salva as credenciais com segurança no seu chaveiro do sistema operacional (criptografado com AES-256-GCM).
Mirar em um agente específico ou instalar habilidadesApós a configuração, instale as habilidades de agente incluídas:
npx skills add https://github.com/googleworkspace/cliOu execute instaladores específicos do agente (por exemplo, para Claude Code ou Cursor). Reinicie seu agente para que ele descubra os comandos do Google Workspace CLI automaticamente.
Configuração em nível de projeto vs. globalPor padrão, a configuração se aplica globalmente. Para configuração apenas de projeto:
gws auth setup --projectAutenticaçãoReautentique ou troque de contas a qualquer momento:
gws auth loginVerifique o usuário atual e os escopos:
gws auth whoamiDesconecte-se quando necessário:
gws auth logoutPara uso sem interface gráfica/CI, exporte as credenciais:
gws auth export --unmasked > creds.json
export GOOGLE_WORKSPACE_CLI_CREDENTIALS_FILE=/path/to/creds.jsonOu reutilize tokens do gcloud: export GOOGLE_WORKSPACE_CLI_TOKEN=$(gcloud auth print-access-token).
TelemetriaDesative a coleta de uso anônimo:
export GOOGLE_WORKSPACE_CLI_NO_TELEMETRY=1Usando comandos principais no Google Workspace CLI (Drive, Gmail, Calendar, Sheets, Docs, Chat)O Google Workspace CLI descobre comandos dinamicamente — sem uma lista fixa. Execute gws --help para ver os serviços disponíveis.
Arquivos e pastas do DriveListar arquivos recentes:
gws drive files list --params '{"pageSize":10, "q":"name contains report"}'Fazer upload com auxiliar:
gws drive +upload ./budget.xlsx --name "2026 Budget"GmailEnviar e-mail:
gws gmail +send --to colleague@example.com --subject "Update" --body "See attached." --attach ./file.pdfResponder ou triar caixa de entrada:
gws gmail +reply --message-id <ID> --body "Thanks!"
gws gmail +triageCalendarCriar evento:
gws calendar +insert --summary "Sprint Planning" --start "2026-03-20T10:00" --end "2026-03-20T11:00" --attendees "team@example.com"Mostrar a agenda de hoje:
gws calendar +agenda --todaySheetsAnexar linha:
gws sheets +append --spreadsheetId <ID> --range "Sheet1!A:C" --values "Task X,Done,2026-03-16"DocsInserir texto:
gws docs +write --documentId <ID> --text "New section added via Google Workspace CLI"ChatPostar mensagem:
gws chat +send --space <SPACE_ID> --text "Deployment complete 🚀"Use --dry-run em qualquer comando para pré-visualizar a chamada de API exata sem executar. Adicione --page-all para paginação completa como NDJSON.
Configuração avançada e opções globais no Google Workspace CLIPersistir configurações com variáveis de ambiente ou arquivo .env:
export GOOGLE_WORKSPACE_CLI_DEFAULT_PARAMS='{"prettyPrint":true}'Ajuste tempos limite, formato de saída (--json, --yaml) ou force o uso de um chaveiro baseado em arquivo. Veja a configuração:
gws configIntegrando o Google Workspace CLI com agentes de IA e promptsUma vez que as habilidades são instaladas, os agentes chamam o Google Workspace CLI nativamente.
O padrão "usar gws"Em prompts: "Listar meus arquivos recentes do Drive usando Google Workspace CLI" ou "Enviar um e-mail de acompanhamento via Google Workspace CLI".
Regra de invocação automáticaAdicione às instruções do seu agente (por exemplo, CLAUDE.md ou regras do Cursor):
"Sempre que a tarefa envolver Gmail, Drive, Calendar, Sheets, Docs ou Chat, use os comandos do Google Workspace CLI automaticamente antes de responder. Resolva o serviço e o método primeiro."
Agentes retornam caminhos de arquivo ou resultados JSON, mantendo o contexto enxuto.
Combine com Apidog para total confiança na APIO Google Workspace CLI torna as APIs do Workspace acessíveis instantaneamente, mas ao depurar payloads, escopos ou respostas, você precisa de visibilidade.
Apidog é um cliente de API gratuito que permite enviar requisições, inspecionar respostas brutas, configurar ambientes com tokens OAuth e automatizar asserções.
Fluxos de trabalho reais:
- Agente sugere adicionar a uma planilha → Teste o payload exato de Sheets.values.append no Apidog primeiro.
- Resolver problemas de escopos de envio do Gmail → Construa e execute a requisição visualmente.
- Armazene chaves de conta de serviço ou tokens de usuário como variáveis → Troque de contas e valide o comportamento.
Google Workspace CLI + Apidog oferece acesso a dados em tempo real mais testes de API verificados e repetíveis.
FAQO Google Workspace CLI envia meus dados externamente?Nenhuma chamada vai diretamente para as APIs do Google. Seu conteúdo nunca sai da sua conta Google.
Quais serviços o Google Workspace CLI suporta?Toda API do Workspace descoberta dinamicamente: Drive, Gmail, Calendar, Sheets, Docs, Chat, Admin, Script e muito mais.
Quão atualizados são os comandos?O Google Workspace CLI consulta o Discovery Service em tempo real — novos métodos aparecem automaticamente.
Ele requer uma chave de API?Usa o OAuth padrão do Google ou contas de serviço — nenhuma chave separada além das credenciais de autenticação.
Quais agentes e editores o Google Workspace CLI suporta?Claude Code, Cursor, OpenClaw, Gemini CLI, extensões VS Code — qualquer ferramenta compatível com MCP ou Agent Skills.
Qual a diferença entre comandos brutos e auxiliares +?Bruto = métodos exatos do Discovery (por exemplo, drive.files.list). + auxiliares = atalhos para tarefas comuns (por exemplo, +upload, +send).
Posso usar o Google Workspace CLI sem um agente de IA?Sim — perfeito para scripts, automação ou uso diário do terminal.
Recursos adicionais
- Repositório GitHub do Google Workspace CLI → https://github.com/googleworkspace/cli
- README completo e documentação → https://github.com/googleworkspace/cli/blob/main/README.md
- Pasta de habilidades de agente → https://github.com/googleworkspace/cli/tree/main/skills
- Referência da API do Google Workspace → https://developers.google.com/workspace
- Painel de cotas → https://console.cloud.google.com/apis/api
- Cliente API gratuito Apidog → https://apidog.com