fluxmail

Fluxmail 是面向 AI 智能体和应用的自托管邮件基础设施，提供 CLI、REST API 与 MCP 服务器三种接入方式。它的核心用途是让智能体与应用程序通过统一接口操作真实邮箱，同时把数据与凭据留在用户自己的环境中。

一、用途 Fluxmail 用于把 Gmail、Google Workspace、Microsoft 365、Outlook.com 以及标准 IMAP/SMTP 邮箱连接到同一个自托管实例，供 AI 智能体、应用和后端工作流使用。

二、主要能力

1. 多邮箱接入：可将 Gmail、Google Workspace、Microsoft 365、Outlook.com 和 IMAP/SMTP 邮箱连接到同一实例。
2. 智能体邮件工具（MCP）：为智能体提供列出、搜索、阅读、草拟、回复、转发、发送、定时发送和整理邮件的工具。
3. 统一操作接口：同样的邮箱操作可通过带版本号的 REST API 和 CLI 完成。
4. 邮件与线程处理：获取完整邮件与对话线程，跨多个邮箱工作，并下载附件。
5. 邮件整理：将邮件标记为已读、加星或归档，在文件夹间移动，移入废纸篓，并管理 Gmail 标签或 Outlook 分类。
6. 权限控制：通过权限配置文件或自定义策略，限制每个客户端只能访问选定的邮箱和执行选定的操作。
7. 成员与邮箱分配：在 Business 和 Enterprise 方案中可添加成员，并选择各自可访问的邮箱。
8. 本地或 Docker 部署：可本地运行或使用 Docker，数据库与加密的提供商凭据保留在自有基础设施上。

三、使用方式

1. 环境要求：Node.js 20.20.x，或 Node.js 22.22 及以上版本。
2. 快速开始流程：按照 quickstart 连接一个邮箱，然后选择使用方式——MCP、REST API 或 CLI。
3. 权限配置建议：常规 MCP 使用推荐 Full access，允许读取、发送、定时发送、草拟、整理以及将邮件移入或移出废纸篓，但不包含永久删除。受限访问可选择 read-write 或 read-only。裸 stdio 以及未设置权限选项而创建的 API key 仍为只读。
4. 本地 MCP 连接：将客户端配置为以参数 ["stdio", "--profile", "full"] 启动 fluxmail。客户端须与初始设置使用相同的操作系统用户和相同的 Fluxmail 数据目录。stdio 使用本地成员会话，不需要 API key，也不需要单独的 HTTP 服务器。可让客户端调用 list_accounts 检查连接；全新实例返回空账户列表。若要投递定时邮件，需保持 fluxmail serve 或 fluxmail scheduled run 以相同数据目录持续运行。
5. 客户端配置参考：仓库内提供 Connect an MCP client 文档，涵盖客户端配置与 HTTP 连接，其中 Cline 部分介绍 MCP 设置和 Cline CLI 配置，也以 llms-install.md 形式提供。
6. REST API 构建：应用与后端工作流通过带版本号的 REST API 使用相同邮箱操作。

四、适用场景

1. 为 AI 智能体提供可读、可写、可整理的邮箱能力。
2. 应用或后端工作流以编程方式处理邮件（列出、搜索、阅读、草拟、发送、定时发送、整理、附件下载等）。
3. 运维人员通过 CLI 连接邮箱、管理访问权限并运行服务。
4. 需要将数据库和加密的提供商凭据保留在自有基础设施上的团队。

五、限制与许可

1. 运行依赖 Node.js 20.20.x，或 Node.js 22.22 及以上版本。
2. Full access 不包含永久删除邮件。
3. 本地 MCP 连接要求客户端与设置使用相同操作系统用户和相同数据目录；定时邮件投递需保持相应命令运行。
4. 方案限制：Personal 方案支持三个邮箱和一名成员；付费方案为共享实例的团队提高这些上限。具体价格信息见 Fluxmail 定价页面。
5. 许可：Fluxmail 以 Elastic License 2.0 源代码公开，可在该许可范围内使用、修改、创建衍生作品和再分发。运行 fork 本身不要求付费订阅，内置 Personal 方案无需付费密钥即可支持三个邮箱和一名成员。官方 Pro、Business 和 Enterprise 权益需要有效的 Fluxmail 许可密钥。ELv2 不允许更改或绕过许可密钥功能、移除受保护功能，或将 Fluxmail 本身作为托管或管理服务提供并暴露其大量功能。Fluxmail 名称和标识的使用还须遵守其服务条款。