mcp-email

Servidor MCP auto-hospedado para qualquer caixa de entrada IMAP/SMTP. Multi-contas em uma única configuração. Construído para Claude Code.

GitHubExperimente este MCPPatrocinado

Documentação

mcp-email

Servidor MCP auto-hospedado para IMAP e SMTP. Multi-contas em uma única configuração. Feito para Claude Code e qualquer cliente compatível com MCP.

Comprar no Gumroad — $49 · Página de destino · Documentação de configuração por provedor

O que é este repositório

Esta é a face pública do mcp-email, um produto pago da OneShotForge. O código-fonte está no pacote pago vendido no Gumroad. Este repositório contém:

O README que você está lendo (recursos, escopo, FAQ)
A documentação completa de configuração por provedor (docs/CONFIG.md)
O changelog público (CHANGELOG.md)
Os termos de licença (LICENSE)

Se você está avaliando: isto é suficiente para decidir se o mcp-email se encaixa na sua configuração. O link de compra está no topo.

Se você já comprou: o código-fonte TypeScript completo, configuração Docker, configs de build e o guia de instalação completo estão no zip que você recebeu após a finalização da compra.

Por que isto existe

A especificação MCP da Anthropic permite que agentes conversem com suas ferramentas. E-mail é a ferramenta mais solicitada. Mas os servidores "MCP email" existentes que testei ou te prendem ao Gmail, exigem uma configuração OAuth que leva uma tarde inteira, ou quebram no momento em que você aponta para uma segunda conta.

mcp-email é o que eu construí para mim mesmo depois dessa triagem. Eu o vendo porque agora ele resolve um problema de forma limpa o suficiente para que eu prefira ser pago para mantê-lo do que mantê-lo de graça.

O que é diferente:

Qualquer provedor IMAP/SMTP — Gmail, Hostinger, Fastmail, iCloud, Outlook 365, Proton (via Bridge), Yahoo, Zoho, domínios personalizados, qualquer coisa que fale o protocolo.
Multi-contas em uma única configuração — declare N contas via variáveis de ambiente, toda chamada de ferramenta recebe um argumento account. Uma única instância do servidor fala com todas elas.
15 ferramentas, nível de produção — listar, buscar, ler, threads, anexos, enviar, rascunho, mover, copiar, excluir, sinalizar, CRUD de pastas. As operações básicas estão cobertas.
Auto-hospedado, credenciais nunca saem da sua máquina — roda localmente via npm ou em Docker. Autenticação por bearer token no endpoint MCP. Sem telemetria, sem proxy SaaS.
Um único arquivo .env — sem dança OAuth, sem JSON de conta de serviço, sem projeto Google Cloud. Gere senhas de aplicativo no lado do provedor, coloque-as lá, pronto.

O que você recebe ao comprar

Após a finalização da compra no Gumroad, você baixa um único zip contendo:

Código-fonte TypeScript completo do servidor (Node 20+, @modelcontextprotocol/sdk, imapflow, nodemailer)
Dockerfile + docker-compose.yml prontos para executar
.env.example com o template completo e comentários inline
O README expandido com instruções de instalação, integração com Claude Code, deploy em produção via Caddy e solução de problemas
Uma licença comercial perpétua (veja LICENSE para os termos completos — uso comercial ilimitado, sem revenda, reembolso no primeiro dia se não se encaixar)
Atualizações gratuitas de patch e menores dentro da versão principal 1.x

Tempo aproximado até a primeira chamada de ferramenta após a compra: 5 minutos se a senha de aplicativo do seu provedor já estiver gerada.

Matriz de provedores

Eu uso Hostinger e Gmail diariamente. A configuração está documentada e testada para os demais.

Provedor	Autenticação	Host IMAP	Host SMTP	Notas
Hostinger	Senha da caixa de correio	`imap.hostinger.com:993`	`smtp.hostinger.com:465`	O que eu uso para `hello@oneshotforge.com`. 10/10 no mail-tester.com.
Gmail / Workspace	Senha de aplicativo	`imap.gmail.com:993`	`smtp.gmail.com:465`	Ative a 2FA primeiro. Administradores do Workspace podem desativar IMAP no nível da organização.
Fastmail	Senha de aplicativo	`imap.fastmail.com:993`	`smtp.fastmail.com:465`	Implementação limpa, sem surpresas.
iCloud Mail	Senha específica do aplicativo	`imap.mail.me.com:993`	`smtp.mail.me.com:587`	SMTP na porta 587/STARTTLS.
Outlook 365	Senha de aplicativo	`outlook.office365.com:993`	`smtp.office365.com:587`	Alguns tenants desativam SMTP AUTH. Contas pessoais sempre funcionam.
Proton Mail	Via Proton Bridge	`127.0.0.1:1143`	`127.0.0.1:1025`	O Bridge precisa estar rodando localmente.
Yahoo Mail	Senha de aplicativo	`imap.mail.yahoo.com:993`	`smtp.mail.yahoo.com:465`	Senha de aplicativo em segurança da conta.
Zoho Mail	Senha de aplicativo (ou normal)	`imap.zoho.eu:993` / `.com`	`smtp.zoho.eu:465` / `.com`	Tenants da UE e dos EUA usam hosts diferentes.
Genérico	Senha de aplicativo ou normal	depende	depende	Qualquer coisa compatível com RFC funciona.

Configuração completa por provedor em docs/CONFIG.md.

As 15 ferramentas

Todas as ferramentas recebem um parâmetro account — o ID que você declarou em .env. As pastas padrão são INBOX quando aplicável.

Leitura (6)

Ferramenta	Finalidade
`email_list_folders`	Listar todas as pastas IMAP com contagens de não lidas
`email_list_messages`	Listar mensagens em uma pasta com paginação e filtro de não lidas
`email_search_messages`	Buscar por remetente, assunto, corpo, data ou tem-anexo
`email_get_message`	Corpo completo da mensagem (texto + HTML + metadados de anexos) por UID
`email_get_attachment`	Buscar o conteúdo de um anexo (UTF-8 ou base64)
`email_get_thread`	Reconstruir uma thread de conversa a partir de Message-ID / In-Reply-To / References

Escrita (2)

Ferramenta	Finalidade
`email_send_message`	Enviar via SMTP, anexar uma cópia à pasta Enviados via IMAP
`email_create_draft`	Criar um rascunho na pasta Rascunhos

Gerenciamento (7)

Ferramenta	Finalidade
`email_move_message`	Mover uma mensagem para outra pasta
`email_copy_message`	Copiar uma mensagem para outra pasta
`email_delete_message`	Mover para Lixeira (padrão) ou `\Deleted` + expurgar
`email_mark_message`	Definir ou remover sinalizações `\Seen` / `\Flagged` / `\Answered`
`email_create_folder`	Criar uma pasta IMAP
`email_rename_folder`	Renomear uma pasta IMAP
`email_delete_folder`	Excluir uma pasta IMAP

Como se conecta ao Claude Code

Após a instalação (coberta no zip), adicione isto ao seu .mcp.json do projeto ou ~/.claude.json global:

{
  "mcpServers": {
    "email": {
      "type": "http",
      "url": "http://localhost:3000/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_MCP_AUTH_TOKEN"
      }
    }
  }
}

Reinicie o Claude Code (/mcp para verificar se o servidor está connected), e então tente:

"Liste meus últimos 5 e-mails não lidos na conta main."

Ou, para uso avançado com multi-contas:

"Busque na conta support mensagens sem resposta de customer@example.com nos últimos 7 dias, resuma-as e crie um rascunho de resposta na conta main."

Preço

$49 pagamento único. Licença comercial perpétua, uso comercial ilimitado, sem taxa recorrente.

Reembolso no mesmo dia se não se encaixar na sua configuração. Envie um e-mail para hello@oneshotforge.com dentro de 24 horas após a compra e eu processarei (na manhã seguinte se eu estiver dormindo quando você escrever).

Comprar no Gumroad

Limites e escopo (intencionais)

Autenticação: apenas senha de aplicativo ou senha normal. Sem OAuth 2.0. Isso mantém o servidor sem estado e agnóstico de provedor.
Transporte: apenas HTTP (sem stdio). MCP sobre HTTP é o único modo que suporta agentes remotos e infraestrutura compartilhada.
Nomes de pastas: os padrões assumem INBOX, Sent, Drafts, Trash. Servidores com prefixos como INBOX.Sent são tratados com um fallback. Nomes personalizados exigem pequenas alterações no código.
Download de anexos: limite de 1 MB para anexos binários (retornados como base64). Anexos textuais (text/*, JSON, XML, ICS) não têm limite.
Corpo HTML: truncado após 25.000 caracteres em email_get_message. O corpo de texto é sempre enviado por completo.

Roadmap (pós-1.0, não comprometido)

Substituições opcionais de env vars SENT_FOLDER / DRAFTS_FOLDER / TRASH_FOLDER por conta
Fluxo OAuth para Gmail e Microsoft (add-on separado, não incluído)
Webhook para e-mails recebidos (notificações push para agentes)
Ponte Calendar/ICS (produto separado, integrará de forma limpa)
Marcação automática por IA via API da Anthropic

Vote por e-mail — o que você quer a seguir? hello@oneshotforge.com.

Licença

Licença comercial — veja LICENSE.

Resumo: uso pessoal e comercial ilimitado após a compra, sem revenda ou redistribuição do código-fonte.

Suporte

Bugs e solicitações de recursos: envie um e-mail para hello@oneshotforge.com com uma reprodução clara.
Perguntas sobre licença, preço por volume: mesmo endereço.
Changelog público: CHANGELOG.md.

Construído por OneShotForge.