Servidor MCP Email | Awesome MCP Servers

mcp-email-server

Um servidor MCP para ler, pesquisar, organizar e enviar e-mails via IMAP e SMTP.

[!NOTE] A versão 1.0.0 apresenta o Local Email App V2. Atualizar o pacote não importa automaticamente as configurações existentes criadas com PyPI 0.16.0 e anteriores: elas permanecem ativas no modo legacy compatível com versões anteriores, portanto não há migração obrigatória. Se você quiser usar o novo armazenamento gerenciado, você pode revisar e importar essas configurações quando for conveniente.

mcp-email-server suporta Windows, macOS e Linux. Consulte Segurança para detalhes de armazenamento de credenciais e sistema de arquivos específicos de cada plataforma.

Migração opcional para instalações existentes

Uma versão @latest que inclui o Local Email App V2 oferece uma migração CLI com pré-visualização:

uvx mcp-email-server@latest config init \
  --database ~/.config/mcp-email-server/managed.sqlite3
uvx mcp-email-server@latest config import-legacy
uvx mcp-email-server@latest config import-legacy --apply
uvx mcp-email-server@latest config doctor

A etapa de aplicação exibe o plano novamente e solicita confirmação IMPORT. Uma importação completa seleciona o modo gerenciado; caso contrário, as configurações legadas existentes permanecem selecionadas. O arquivo TOML de origem e suas entradas de chaveiro legadas são deixados intactos. Você também pode executar uvx mcp-email-server@latest ui e escolher Importar configurações existentes. Após uma importação bem-sucedida, reinicie os clientes MCP em execução. Consulte o guia de atualização detalhado e solução de problemas de importação.

Início rápido

1. Configure uma conta de e-mail

A partir deste checkout do código-fonte, execute a interface de configuração com uv:

uv sync
uv run mcp-email-server ui

Para uma versão publicada cujas notas indiquem que ela inclui o Local Email App V2, uvx mcp-email-server@latest ui é a invocação temporária equivalente.

Mantenha o comando em primeiro plano em execução. Em uma instalação verdadeiramente vazia, a sessão autenticada do navegador prepara o armazenamento privado da conta no padrão local seguro; a configuração TOML ou de variáveis de ambiente existente, em vez disso, oferece uma revisão de importação explícita enquanto as configurações anteriores continuam em execução. A interface focada em conta tem apenas Contas de e-mail e Configurações e ajuda como destinos principais. Comece com o endereço de e-mail e a senha; a interface preenche as configurações de conexão comuns a partir do domínio do e-mail e as mantém editáveis, enquanto o envio de mensagens permanece opcional. Uma conta completa salva está pronta sem uma etapa de ativação separada. Use Senha e teste na conta salva, se desejado, e reinicie o cliente MCP para aplicar as configurações selecionadas.

2. Configure o cliente MCP

Use a mesma distribuição compatível com V2 para stdio e para a interface. Para uma versão V2 publicada, adicione a seguinte definição de servidor ao cliente MCP:

{
  "mcpServers": {
    "mcp-email-server": {
      "command": "uvx",
      "args": ["mcp-email-server@latest", "stdio"]
    }
  }
}

Reinicie o cliente MCP após atualizar sua configuração. Ao testar este checkout do código-fonte antes da publicação, invoque uv run --directory /caminho/absoluto/para/mcp-email-server mcp-email-server stdio em vez de emparelhar um catálogo gerenciado com PyPI @latest.

3. Verifique a conexão

Peça ao cliente para listar as contas de e-mail configuradas ou mensagens recentes.

Outros métodos de configuração

Para o fluxo de trabalho CLI gerenciado com suporte a SQLite, limites de armazenamento Windows e POSIX, ambientes headless, múltiplas contas, configurações TLS personalizadas e configuração por variáveis de ambiente, consulte a documentação. A versão 1.6.2 e posteriores também publicam imagens Linux amd64/arm64 em ghcr.io/wh1isper/mcp-email-server; consulte as instruções para contêineres.

MCP Email Server

Documentação