convez.ai
MCP ServerIntegração & APIsIntermediário
ssanchez-SnD

Email MCP Server

ssanchez-SnD/email-mcp-ts

Acesso IMAP/SMTP completo para Claude via MCP com leitura, escrita e respostas

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP em TypeScript que expõe ferramentas completas para gerenciamento de email via IMAP/SMTP. Suporta leitura, busca, movimentação, exclusão, criação de rascunhos e respostas seguras com sincronização automática da pasta Sent.

Instalação

$npx convez-ai ssanchez-SnD/email-mcp-ts

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
2

Casos de uso

  • Automação de processamento de emails em workflows Claude
  • Gerenciamento de caixa de entrada com busca e organização programática
  • Envio de respostas automáticas e criação de rascunhos via AI

Veredito

Implementação sólida e bem validada de integração IMAP/SMTP via MCP, com suporte a operações críticas (envio, rascunhos) e tratamento robusto de pastas especiais. Excelente para automação de email em workflows Claude, com segurança adequada para credenciais.

README

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

email-mcp-ts

Servidor MCP remoto en TypeScript para correo IMAP/SMTP con lectura y escritura. Expone herramientas para consultar, buscar, mover, eliminar, marcar, crear borradores y responder mensajes, guardando copias enviadas en la carpeta Sent del servidor.

Estado

  • Soporta lectura de buzón, detalle de mensajes, búsqueda y paginación.
  • Soporta escritura segura: mover, borrar, actualizar flags, crear borradores y responder por SMTP.
  • Resuelve carpetas especiales como Sent y Drafts por specialUse, con respaldo por configuración.
  • Validado contra un servidor real con autenticación IMAP y SMTP.

Herramientas

ToolDescripción
get_unread_countDevuelve total y no leídos del buzón configurado
list_foldersLista carpetas IMAP con metadatos y specialUse
list_recent_emailsLista correos recientes con cursor
get_emailDevuelve el detalle completo de un mensaje
search_emailsBusca por remitente, destinatario, asunto, texto, flags o carpetas
move_emailMueve un correo a otra carpeta
delete_emailElimina un correo
update_email_flagsMarca seen, flagged, deleted, draft o answered
create_draftGuarda un borrador en Drafts
reply_emailResponde por SMTP y guarda copia en Sent

Requisitos

  • Node.js 22+
  • Acceso IMAP y SMTP al servidor de correo
  • Variables de entorno para credenciales y carpetas especiales

Configuración

Copiar .env.example a .env y completar los valores.

Variables importantes:

  • PORT y MCP_PATH
  • API_KEY
  • IMAP_HOST, IMAP_PORT, IMAP_SECURE, IMAP_USERNAME, IMAP_PASSWORD, IMAP_MAILBOX
  • SMTP_HOST, SMTP_PORT, SMTP_SECURE, SMTP_USERNAME, SMTP_PASSWORD, SMTP_FROM
  • SENT_MAILBOX, DRAFTS_MAILBOX, TRASH_MAILBOX si el servidor no expone specialUse

Desarrollo local

npm install
npm run dev

Producción con Docker

docker compose up -d --build

Seguridad

  • Nunca subas .env al repositorio
  • No imprimas API_KEY, IMAP_PASSWORD ni credenciales SMTP
  • Usa HTTPS en producción
  • Rota las credenciales periódicamente

Validación

La implementación fue verificada con pruebas sobre un buzón real para confirmar:

  • autenticación IMAP y SMTP
  • resolución de carpetas Sent y Drafts
  • búsqueda y lectura de mensajes
  • movimiento, borrado y actualización de flags
  • creación de borradores
  • envío de respuestas con copia guardada en Sent
Ver o original no GitHub

Bom para

Relacionados