gws-gmail-watch
Ajuda seu agente a monitorar e receber novos e-mails do Gmail. Permite que o agente processe informações de e-mails em tempo real.
O que ela faz
Este comando fica de olho na sua caixa de entrada do Gmail para novos e-mails. Quando um novo e-mail chega, ele o envia como um texto formatado (NDJSON).
Quando usar
- ✓Quando você quer ser notificado sobre e-mails importantes assim que chegam.
- ✓Ao automatizar tarefas que dependem de novos e-mails (como processar pedidos).
- ✓Para monitorar e-mails específicos com base em marcadores (labels).
Exemplo do que pedir para a IA
“Fique de olho em novos e-mails na minha caixa de entrada e me avise quando chegar um.”
Quer saber mais? Abra as seções abaixo.
Como usar
O jeito mais fácil: copie a mensagem abaixo e cole no Claude, ChatGPT, Cursor ou outra IA. Ela lê a skill e segue as instruções.
Link da skill
Mensagem pronta para colar
Como funciona
Ele usa um serviço do Google Cloud para receber notificações de novos e-mails do Gmail. Essas notificações são então enviadas para você em um formato de texto fácil de ler por outros programas.
Instalação
Jeito mais fácil: copie o link da skill e cole no Claude, ChatGPT ou Cursor pedindo para seguir as instruções.
No terminal (Claude Code, Codex, Cursor), na pasta do projeto:
npx skills add googleworkspace/cli --skill gws-gmail-watchOu baixe só o arquivo:
curl -L https://raw.githubusercontent.com/googleworkspace/cli/main/skills/gws-gmail-watch/SKILL.md -o SKILL.mdConteúdo técnico (SKILL.md)
Tradução do texto original do autor no GitHub. Os comandos e códigos estão como no original.
gmail +watch
PRÉ-REQUISITO: Leia
../gws-shared/SKILL.mdpara autenticação, flags globais e regras de segurança. Se estiver faltando, executegws generate-skillspara criá-lo.
Observe novos e-mails e transmita-os como NDJSON
Uso
gws gmail +watch
Flags
| Flag | Obrigatório | Padrão | Descrição |
|---|---|---|---|
--project |
— | — | ID do projeto GCP para recursos do Pub/Sub |
--subscription |
— | — | Nome da assinatura Pub/Sub existente (pula configuração) |
--topic |
— | — | Tópico Pub/Sub existente com permissão de push do Gmail já concedida |
--label-ids |
— | — | IDs de rótulos do Gmail separados por vírgula para filtrar (ex: INBOX,UNREAD) |
--max-messages |
— | 10 | Máximo de mensagens por lote de pull |
--poll-interval |
— | 5 | Segundos entre os pulls |
--msg-format |
— | full | Formato da mensagem do Gmail: full, metadata, minimal, raw |
--once |
— | — | Puxa uma vez e sai |
--cleanup |
— | — | Exclui recursos Pub/Sub criados ao sair |
--output-dir |
— | — | Escreve cada mensagem em um arquivo JSON separado neste diretório |
Exemplos
gws gmail +watch --project my-gcp-project
gws gmail +watch --project my-project --label-ids INBOX --once
gws gmail +watch --subscription projects/p/subscriptions/my-sub
gws gmail +watch --project my-project --cleanup --output-dir ./emails
Dicas
- O watch do Gmail expira após 7 dias — execute novamente para renovar.
- Sem --cleanup, os recursos do Pub/Sub persistem para reconexão.
- Pressione Ctrl-C para parar graciosamente.
Veja Também
- gws-shared — Flags globais e autenticação
- gws-gmail — Todos os comandos de envio, leitura e gerenciamento de e-mail
Perguntas frequentes
Como eu paro de monitorar os e-mails?
Você pode parar o comando pressionando Ctrl+C no seu teclado.
O que acontece com os e-mails que chegam?
Eles são enviados como um texto formatado (NDJSON) para você. Você pode configurar para salvá-los em arquivos se desejar.
Preciso configurar algo no Google Cloud?
Sim, pode ser necessário configurar um projeto no Google Cloud para que o serviço funcione. O comando tenta configurar isso para você, mas pode pedir informações adicionais.
Detalhes
Descrição original do autor
Gmail: Watch for new emails and stream them as NDJSON.
repo: googleworkspace/cli
Popularidade
- Estrelas no GitHub
- 32 mil
- Posição no ranking
- #6271
- Licença
- Apache-2.0
- Atualizada em
- 06/10/2026
Comentários
- …
Mais skills deste repositório
gws-admin-reports
Ajuda seu agente a obter relatórios de atividades do Google Workspace. Ele coleta dados de auditoria e uso.
googleworkspace/cli
gws-calendar-agenda
Ajuda seu agente a ver eventos futuros em todos os calendários. É útil para organizar sua agenda e saber o que está por vir.
googleworkspace/cli
gws-calendar-insert
Faz seu agente criar novos eventos no Google Agenda. É útil para agendar compromissos e reuniões.
googleworkspace/cli
gws-calendar
Permite que seu agente gerencie calendários e eventos. É útil para organizar sua vida e trabalho.
googleworkspace/cli
Skills parecidas
google-workspace-ops
Opera com documentos do Google Workspace (Drive, Docs, Sheets, Slides) como um fluxo de trabalho unificado. Facilita encontrar, resumir e editar seus arquivos sem sair da ferramenta.
affaan-m/ECC
Dynamics 365 Automation
Ajuda seu agente a gerenciar informações de clientes no Dynamics 365. Ele pode lidar com contatos, vendas e casos, tornando o trabalho mais organizado.
ComposioHQ/awesome-claude-skills
Excel Automation
Ajuda seu agente a trabalhar com planilhas no Excel e Google Sheets. Ele pode criar, editar e formatar arquivos.
ComposioHQ/awesome-claude-skills