Fluxmail

Servidor de e-mail auto-hospedado com CLI / API / MCP para agentes e aplicativos de IA

Documentação

Fluxmail

CI npm version Container image

Fluxmail é uma infraestrutura de e-mail auto-hospedada para agentes e aplicativos. Ela se conecta a caixas de correio do Gmail, Microsoft 365, Outlook.com e IMAP/SMTP. Agentes usam MCP, aplicativos e fluxos de trabalho de backend usam a API REST versionada, e operadores usam a CLI para conectar caixas de correio, gerenciar acesso e executar o serviço.

Recursos

  • 📬 Conecte caixas de correio do Gmail, Google Workspace, Microsoft 365, Outlook.com e IMAP/SMTP a uma única instância.
  • 🤖 Dê aos agentes ferramentas MCP para listar, pesquisar, ler, rascunhar, responder, encaminhar, enviar, agendar e organizar e-mails.
  • 🔌 Use as mesmas operações de caixa de correio pela API REST versionada e pela CLI.
  • 🧵 Busque mensagens e conversas completas, trabalhe em várias caixas de correio e baixe anexos.
  • 🗂️ Marque e-mails como lidos, favoritos ou arquivados, mova-os entre pastas, envie-os para a Lixeira e gerencie rótulos do Gmail ou categorias do Outlook.
  • 🔐 Limite cada cliente a caixas de correio e ações selecionadas com perfis de permissão ou políticas personalizadas.
  • 👥 Adicione membros e escolha quais caixas de correio cada um pode acessar nos planos Business e Enterprise.
  • 🏠 Execute o Fluxmail localmente ou no Docker mantendo seu banco de dados e credenciais de provedor criptografadas na sua infraestrutura.

Comece agora

O Fluxmail requer Node.js 20.20.x, ou Node.js 22.22 ou posterior.

npm install -g fluxmail
fluxmail setup --name "Your name" --email you@example.com

Em seguida, siga o guia de início rápido para conectar uma caixa de correio e escolher como você quer usar o Fluxmail: MCP, REST API ou CLI.

Recomendamos Acesso total para uso normal com MCP. Ele permite ler, enviar, agendar, rascunhar, organizar e mover e-mails para dentro ou fora da Lixeira. Ele exclui a exclusão permanente. Escolha read-write ou read-only para acesso restrito. Stdio puro e criação de chaves de API sem opções de permissão permanecem somente leitura.

Para uma conexão MCP local, configure seu cliente para iniciar fluxmail com os argumentos ["stdio", "--profile", "full"]. O cliente deve ser executado como o mesmo usuário do sistema operacional e usar o mesmo diretório de dados do Fluxmail que a configuração. O Stdio usa a sessão de membro local; ele não precisa de uma chave de API ou de um servidor HTTP separado. Peça ao cliente para chamar list_accounts para verificar a conexão. Uma instância nova retorna uma lista de contas vazia. Para entregar e-mails agendados, mantenha fluxmail serve ou fluxmail scheduled run em execução com o mesmo diretório de dados.

Consulte Conectar um cliente MCP para configuração de cliente e conexões HTTP. A seção Cline cobre as configurações de MCP e a configuração da CLI do Cline, também disponível como llms-install.md neste repositório.

Documentação

Planos e licença

O plano Personal suporta três caixas de correio e um membro. Os planos pagos aumentam esses limites para equipes que compartilham uma instância. Consulte Preços do Fluxmail para detalhes atuais.

O Fluxmail tem código-fonte disponível sob a Elastic License 2.0. Você pode usar, modificar, criar obras derivadas e redistribuir o Fluxmail sujeito a essa licença. Executar um fork não exige, por si só, uma assinatura paga do Fluxmail, e o plano Personal integrado suporta três caixas de correio e um membro sem uma chave paga.

Os direitos oficiais Pro, Business e Enterprise exigem uma chave de licença válida do Fluxmail. A ELv2 não permite que você altere ou contorne a funcionalidade da chave de licença, remova funcionalidade protegida ou forneça o próprio Fluxmail como um serviço hospedado ou gerenciado que exponha um conjunto substancial de seus recursos. O uso do nome e dos logotipos do Fluxmail também está sujeito aos Termos de Serviço do Fluxmail.