convez.ai
AgenteAutomaçãoIntermediário
amasawa

MailSlim

amasawa/MailSlim

Limpeza de email assistida por IA com autenticação multi-provedor

Ver no GitHub
InicialPluginScore · de 0 a 100

Agent CLI acionado por Claude para limpeza inteligente de caixas de email. Faz login automático em múltiplos provedores (Gmail, Outlook, 126), aplica regras baseadas em LLM e deleta emails em lote com revisão manual antes da execução.

Instalação

$npx convez-ai amasawa/MailSlim

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Pesquisadores removendo spam e notificações de massa das caixas de email
  • Gerenciamento de múltiplas contas de email com regras consistentes
  • Arquivamento e exclusão em lote com aprovação antes da execução

Veredito

MailSlim resolve um problema real para pesquisadores: limpeza sistemática de email sem perder mensagens importantes. A abordagem de revisão manual antes de deletar é prudente, e suporte a múltiplos provedores (incluindo autenticação criativa para Outlook corporativo) é um diferencial. Requer configuração inicial cuidadosa com credenciais.

README

A tradução para o português deste README ainda está na fila.

MailSlim

A Claude Code (CLI) driven email cleaning agent for researchers. Automatically log into multiple mailboxes, apply rule-based filtering, and batch-delete junk.

Project Structure

MailSlim/
├── config.yaml           # Your credentials (git-ignored)
├── config.example.yaml   # Template
├── rules.md              # Delete / keep rules
├── cleanMailSkill.md     # Claude Code skill definition
└── src/                  # Source code
  • config.yaml — Fill in your email credentials. Never committed.
  • rules.md — Rules for what to delete and what to keep. Structured for both humans and LLMs to understand.

TODO List

  • Auto-login: Gmail, Outlook, 126
  • LLM-driven batch deletion

Property 1: Login & Authentication

Supported Providers

ProviderProtocolAuth Method
GmailIMAPApp Password (generate here)
Outlook / Office 365REST APIPersistent Chrome session (see below)
126 / 163 MailIMAPAuthorization code (授权码)

Outlook: Why Chrome?

University/enterprise tenants often block IMAP basic auth, restrict OAuth2 app registrations, and issue SPA-only tokens. MailSlim works around this by launching a real Chrome browser: you log in once with MFA, cookies are saved, and subsequent runs use headless Chrome to silently extract a fresh token. Session lasts ~30 days.

126 Mail: Setup

  1. Enable IMAP in web settings (Settings → POP3/SMTP/IMAP)
  2. Generate an authorization code (授权码)
  3. Enable "expose all folders to IMAP" (将所有邮件文件夹暴露给IMAP)

Property 2: LLM-Driven Batch Deletion

Workflow

fetch  →  generate candidate list (Excel)  →  manual review & approval  →  CC delete  →  CC archive (optional)
python3 src/main.py fetch <provider>       # Generates delete_candidates.xlsx
python3 src/main.py delete <provider>      # Deletes approved emails
python3 src/main.py archive <provider>     # Archives old emails

Providers: gmail, outlook, 126

Rules (rules.md)

Two sections: Delete and Not Delete. Whitelist always wins.

Delete — by keyword (unsubscribe, promotion...), sender pattern (noreply@*...), category (social notifications, verification codes...), specific senders (LinkedIn, Uber...)

Not Delete — .edu domains, academic platforms (OpenReview, Springer, arXiv, top conferences...), emails with attachments, invoices, paper submissions

To add rules: edit rules.md + the corresponding list in src/rules_engine.py.

Ver o original no GitHub

Bom para

Relacionados