fluxmail

中文文档
0.21.1发布于 2026/11/04Elastic-2.0TypeScriptES Module构建来源已验证

Self-hosted email API with MCP and REST support for Gmail, Outlook, and IMAP/SMTP

原始使用文档
文档目录3 节
  1. Install
  2. Documentation
  3. License

Fluxmail

Fluxmail is self-hosted email infrastructure for agents and apps. It connects to Gmail, Microsoft 365, Outlook.com, and IMAP/SMTP mailboxes. Agents use MCP, apps and backend workflows use the versioned REST API, and operators use the CLI to connect mailboxes, manage access, and run the service.

Install

Fluxmail requires Node.js 22.22 or later.

npm install -g fluxmail
fluxmail setup --name "Your name" --email [email protected]

Then follow the quickstart to connect a mailbox and choose how you want to use Fluxmail: MCP, REST API, or CLI.

Documentation

Fluxmail supports stdio for local MCP clients. Its HTTP server provides Streamable HTTP MCP and REST for local, Docker, and remote deployments. Use an exact package version instead of @latest when you need a reproducible installation.

License

Fluxmail is source available under the Elastic License 2.0. You may use, modify, create derivative works, and redistribute it subject to that license. The Personal plan supports three mailboxes and one member without a paid key. Official Pro, Business, and Enterprise entitlements require a valid Fluxmail license key.

版本与发布记录

fluxmail 共发布 31 个版本,首次发布于 2026/07/08;过去 12 个月发布了 31 个版本。最新版本附带 npm provenance 构建来源证明,可追溯到公开的 CI 构建记录。

版本发布日期距今
0.21.1latest2026/11/04今天
0.21.02026/11/03今天
0.20.02026/11/012 天前
0.19.12026/10/314 天前
0.19.02026/10/296 天前
0.18.02026/10/287 天前

关于 fluxmail 的常见问题

fluxmail 是什么?

自托管电子邮件API,支持针对Gmail、Outlook和IMAP/SMTP的MCP和REST

如何安装 fluxmail?

在项目目录运行 npm install fluxmail,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 fluxmail,可以用 npx fluxmail 直接运行。

fluxmail 支持 TypeScript 吗?

支持。包内自带 TypeScript 类型声明(package.json 声明了 types 入口),安装后即可获得类型提示,无需再安装 @types 包。

fluxmail 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

fluxmail 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.22.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

fluxmail 可以商用吗?

fluxmail 使用 Elastic-2.0 许可。声明的许可为 Elastic-2.0,请阅读许可原文确认使用条件。以上为概括,不构成法律意见,请以许可原文为准。

fluxmail 还在维护吗?

最新版本 0.21.1 发布于 2026/11/04(今天);至今共发布 31 个版本,其中过去 12 个月发布了 31 个;首次发布于 2026/07/08。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。