# 1. Instalar dependências
pip install -r requirements.txt

# 2. Configurar variáveis de ambiente
cp .env.example .env
# Editar .env com suas chaves

# 3. Baixar credentials.json do Google Cloud Console
# (APIs & Services > Credentials > OAuth 2.0 Client IDs)
# Salvar em config/credentials.json

python run.py

Gmail Guardian — Agente de gerenciamento de emails
Digite 'sair' para encerrar | 'log' para ver auditoria

Você: triar meus emails não lidos
Agente: Buscando emails não lidos...

python run.py --mcp

{
  "mcpServers": {
    "gmail": {
      "command": "python",
      "args": ["/caminho/para/email-guardian/run.py", "--mcp"],
      "env": {
        "ANTHROPIC_API_KEY": "sk-ant-...",
        "GOOGLE_CREDENTIALS_PATH": "/caminho/para/credentials.json"
      }
    }
  }
}

/triagem-email
/limpar-promocoes
/resumir-importantes

email-guardian/
├── .claude/              # Configuração do agente e skills para Claude Code
│   ├── agents/           # Definição do agente gmail-guardian
│   └── skills/           # Skills invocáveis via /skill-name
├── agent/                # Orquestração do agente (Anthropic SDK)
├── gmail_mcp/            # MCP Server + ferramentas Gmail
│   ├── services/         # Wrappers da Gmail API
│   ├── tools/            # Implementação das ferramentas MCP
│   └── schemas/          # Dataclasses para tipagem
├── config/               # Settings, políticas e categorias
├── tests/                # Testes unitários
├── .env.example          # Template de variáveis de ambiente
├── requirements.txt
└── run.py                # Entry point

pytest tests/ -v