Fluxmail
Servidor de e-mail auto-hospedado com CLI / API / MCP para agentes e aplicativos de IA
Documentação
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
- Visão geral
- Ferramentas MCP
- Desenvolva com REST
- API REST
- Permissões
- Configuração
- Referência da CLI
- Configuração do Gmail
- Configuração do Outlook
- Configuração do IMAP
- Arquitetura
- Equipes e planos
- Autenticação e instâncias
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.