Fluxmail

Servidor de correo electrónico autohospedado con CLI / API / MCP para agentes y aplicaciones de IA

Documentación

Fluxmail

CI npm version Container image

Fluxmail es una infraestructura de correo electrónico autoalojada para agentes y aplicaciones. Se conecta a Gmail, Microsoft 365, Outlook.com y buzones IMAP/SMTP. Los agentes usan MCP, las aplicaciones y los flujos de trabajo de backend usan la API REST versionada, y los operadores usan la CLI para conectar buzones, gestionar accesos y ejecutar el servicio.

Características

  • 📬 Conecta buzones de Gmail, Google Workspace, Microsoft 365, Outlook.com e IMAP/SMTP a una sola instancia.
  • 🤖 Ofrece a los agentes herramientas MCP para listar, buscar, leer, redactar, responder, reenviar, enviar, programar y organizar correos.
  • 🔌 Usa las mismas operaciones de buzón desde la API REST versionada y la CLI.
  • 🧵 Obtén mensajes e hilos completos, trabaja con varios buzones y descarga archivos adjuntos.
  • 🗂️ Marca correos como leídos, destácalos o archívalos, muévelos entre carpetas, envíalos a la Papelera y gestiona etiquetas de Gmail o categorías de Outlook.
  • 🔐 Limita cada cliente a buzones y acciones seleccionados con perfiles de permisos o políticas personalizadas.
  • 👥 Añade miembros y elige qué buzones puede acceder cada uno en los planes Business y Enterprise.
  • 🏠 Ejecuta Fluxmail localmente o en Docker mientras mantienes su base de datos y credenciales de proveedor cifradas en tu infraestructura.

Comenzar

Fluxmail requiere Node.js 20.20.x, o Node.js 22.22 o posterior.

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

Luego sigue la guía de inicio rápido para conectar un buzón y elegir cómo quieres usar Fluxmail: MCP, API REST o CLI.

Recomendamos Acceso completo para el uso normal de MCP. Permite leer, enviar, programar, redactar, organizar y mover correos hacia o desde la Papelera. Excluye la eliminación permanente. Elige read-write o read-only para acceso restringido. El stdio básico y la creación de claves API sin opciones de permisos permanecen de solo lectura.

Para una conexión MCP local, configura tu cliente para lanzar fluxmail con los argumentos ["stdio", "--profile", "full"]. El cliente debe ejecutarse como el mismo usuario del sistema operativo y usar el mismo directorio de datos de Fluxmail que la configuración. Stdio usa la sesión de miembro local; no necesita una clave API ni un servidor HTTP separado. Pide al cliente que llame a list_accounts para verificar la conexión. Una instancia nueva devuelve una lista de cuentas vacía. Para entregar correos programados, mantén fluxmail serve o fluxmail scheduled run ejecutándose con el mismo directorio de datos.

Consulta Conectar un cliente MCP para la configuración del cliente y las conexiones HTTP. Su sección de Cline cubre la configuración de MCP y la configuración de la CLI de Cline, también disponible como llms-install.md en este repositorio.

Documentación

Planes y licencia

El plan Personal admite tres buzones y un miembro. Los planes de pago aumentan esos límites para equipos que comparten una instancia. Consulta Precios de Fluxmail para obtener detalles actuales.

Fluxmail tiene código fuente disponible bajo la Licencia Elastic 2.0. Puedes usar, modificar, crear obras derivadas y redistribuir Fluxmail sujeto a esa licencia. Ejecutar una bifurcación no requiere por sí mismo una suscripción de pago de Fluxmail, y el plan Personal integrado admite tres buzones y un miembro sin una clave de pago.

Los derechos oficiales de Pro, Business y Enterprise requieren una clave de licencia válida de Fluxmail. ELv2 no permite cambiar o eludir la funcionalidad de la clave de licencia, eliminar funcionalidad protegida, ni proporcionar Fluxmail en sí como un servicio alojado o gestionado que exponga un conjunto sustancial de sus características. El uso del nombre y los logotipos de Fluxmail también está sujeto a los Términos de servicio de Fluxmail.