aiagentwithdhruv/skills

Gerenciar e-mails em várias contas do Gmail com ferramentas unificadas. Use quando o usuário pedir para verificar e-mails, ler a caixa de entrada, rotular e-mails, arquivar mensagens ou gerenciar o Gmail em várias contas.

O que é skills?

Este skill capacita agentes de IA a gerenciar e-mails de múltiplas contas do Gmail de forma unificada, utilizando um conjunto de scripts Python. Ele permite verificar e-mails não lidos, aplicar rótulos, arquivar mensagens e criar filtros, tudo através de uma única interface de linha de comando. O skill é ideal para desenvolvedores e usuários que precisam automatizar o gerenciamento de várias caixas de entrada, oferecendo suporte a contas pessoais e corporativas. Ele funciona autenticando-se via OAuth 2.0 (com escopos como `gmail.modify` e `gmail.labels`) e armazena as credenciais localmente no diretório raiz. Os scripts principais incluem `gmail_unified.py` para operações no inbox, suporte a dry-run para pré-visualização, e `gmail_multi_auth.py` para autenticação de múltiplas contas. É compatível com skills como `gmail-label` e `instantly-autoreply`, e é gratuito, dependendo apenas da API do Gmail.

Funciona com~Claude Code~Codex CLI~Cursor

npx skills add https://github.com/aiagentwithdhruv/skills/tree/HEAD/gmail-inbox

Documentação

Gerenciamento de Caixa de Entrada do Gmail

Objetivo

Verificar e gerenciar e-mails em várias contas do Gmail usando ferramentas unificadas.

Scripts

./scripts/gmail_unified.py - Verificar e gerenciar caixas de entrada
./scripts/gmail_multi_auth.py - Autenticar contas
./scripts/gmail_bulk_label.py - Rotulagem em massa
./scripts/gmail_create_filters.py - Criar filtros
./scripts/gmail_auth.py - Auxiliar de autenticação

Referência Rápida

# Verificar não lidos em todas as contas
python3 ./scripts/gmail_unified.py --query "is:unread" --limit 50

# Verificar apenas uma conta específica
python3 ./scripts/gmail_unified.py --query "is:unread" --account suaempresa

# Listar contas registradas
python3 ./scripts/gmail_unified.py --accounts

# Rotular e arquivar e-mails
python3 ./scripts/gmail_unified.py --query "from:notifications@" --label "Notificações" --archive

# Marcar como lido
python3 ./scripts/gmail_unified.py --query "from:noreply@" --mark-read

# Simulação (pré-visualização)
python3 ./scripts/gmail_unified.py --query "subject:fatura" --label "Faturas" --dry-run

Registro de Contas

Conta	Email	Credenciais	Token
seuusuario	[email protected]	credentials.json	token_seuusuario.json
suaempresa	[email protected]	credentials_suaempresa.json	token_suaempresa.json

Solução de Problemas de Autenticação

"Arquivo de token não encontrado"

python3 ./scripts/gmail_multi_auth.py --account suaempresa --email [email protected]

"invalid_scope: Bad Request"

rm token_seuusuario.json
python3 ./scripts/gmail_multi_auth.py --account seuusuario --email [email protected]

"Falha na autenticação" Verifique se o arquivo credentials.json existe no diretório raiz.

Escopos Necessários

gmail.modify - Ler/escrever e-mails
gmail.labels - Criar/gerenciar rótulos
gmail.settings.basic - Gerenciar configurações
spreadsheets - Acesso ao Google Sheets
drive - Acesso ao Google Drive

Localização das Credenciais

Todos os arquivos de credenciais devem estar no diretório raiz do workspace:

credentials.json / credentials_suaempresa.json - Configurações do cliente OAuth
token_*.json - Tokens de autenticação (gerados automaticamente)
gmail_accounts.json - Registro de contas

Esquema

Entradas

Nome	Tipo	Obrigatório	Descrição
`query`	string	Não	Consulta de pesquisa do Gmail (ex.: 'is:unread')
`account`	string	Não	Nome específico da conta no registro
`limit`	integer	Não	Máximo de e-mails a buscar (padrão: 50)

Saídas

Nome	Tipo	Descrição
`emails`	array	Lista de objetos de e-mail com assunto, remetente, data, resumo

Credenciais

Nome	Origem
`credentials.json`	arquivo
`token_*.json`	arquivo (gerado automaticamente)

Compostível Com

Skills que se encadeiam bem com este: gmail-label, instantly-autoreply

Custo

Gratuito (API do Gmail)