npm fluxmailstdioupdated 1mo ago
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.
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.
Features
- 📬 Connect Gmail, Google Workspace, Microsoft 365, Outlook.com, and IMAP/SMTP mailboxes to one instance.
- 🤖 Give agents MCP tools to list, search, read, draft, reply, forward, send, schedule, and organize email.
- 🔌 Use the same mailbox operations from the versioned REST API and CLI.
- 🧵 Fetch complete messages and threads, work across several mailboxes, and download attachments.
- 🗂️ Mark mail as read, star or archive it, move it between folders, send it to Trash, and manage Gmail labels or Outlook categories.
- 🔐 Limit each client to selected mailboxes and actions with permission profiles or custom policies.
- 👥 Add members and share selected mailboxes on Team and Enterprise plans.
- 🏠 Run Fluxmail locally or in Docker while keeping its database and encrypted provider credentials on your infrastructure.
Get started
Fluxmail requires Node.js 20.20.x, or Node.js 22.22 or later.
npm install -g fluxmail
fluxmail setup --name "Your name" --email you@example.com
Then follow the quickstart to connect a mailbox and choose how you want to use Fluxmail: MCP, REST API, or CLI.
Documentation
- Overview
- MCP tools
- Build with REST
- REST API
- Permissions
- Configuration
- CLI reference
- Gmail setup
- Outlook setup
- IMAP setup
- Architecture
- Teams and plans
- Authentication and instances
Plans and license
The Personal plan supports three mailboxes and one member. Paid plans raise those limits for teams that share an instance. See Fluxmail pricing for current details.
Fluxmail is source available under the Elastic License 2.0. You may use, modify, create derivative works, and redistribute Fluxmail subject to that license. Running a fork does not by itself require a paid Fluxmail subscription, and the built-in Personal plan supports three mailboxes and one member without a paid key.
Official Pro and Team entitlements require a valid Fluxmail license key. ELv2 does not allow you to change or circumvent license key functionality, remove protected functionality, or provide Fluxmail itself as a hosted or managed service that exposes a substantial set of its features. Use of the Fluxmail name and logos is also subject to the Fluxmail Terms of Service.
安装
把 Fluxmail 添加到你的客户端。选择你正在使用的那个。
claude mcp add fluxmail -- npx -y fluxmailcodex mcp add fluxmail -- npx -y fluxmailamp mcp add fluxmail -- npx -y fluxmail{
"mcpServers": {
"fluxmail": {
"command": "npx",
"args": [
"-y",
"fluxmail"
]
}
}
}Add to `claude_desktop_config.json`, then restart Claude Desktop.
{
"mcpServers": {
"fluxmail": {
"command": "npx",
"args": [
"-y",
"fluxmail"
]
}
}
}Add to `~/.cursor/mcp.json`, or `.cursor/mcp.json` for a single project.
code --add-mcp '{"name":"fluxmail","command":"npx","args":["-y","fluxmail"]}'Or add the block manually to `.vscode/mcp.json` under `servers`.
{
"mcpServers": {
"fluxmail": {
"command": "npx",
"args": [
"-y",
"fluxmail"
]
}
}
}Add to `~/.codeium/windsurf/mcp_config.json`.
{
"mcpServers": {
"fluxmail": {
"command": "npx",
"args": [
"-y",
"fluxmail"
]
}
}
}Add to `cline_mcp_settings.json` via the MCP Servers panel.
{
"mcpServers": {
"fluxmail": {
"command": "npx",
"args": [
"-y",
"fluxmail"
]
}
}
}Add to `~/.gemini/settings.json`.
{
"mcpServers": {
"fluxmail": {
"type": "local",
"command": "npx",
"args": [
"-y",
"fluxmail"
],
"tools": [
"*"
]
}
}
}Add to `~/.copilot/mcp-config.json`, or run `/mcp add` inside the CLI.
{
"context_servers": {
"fluxmail": {
"command": {
"path": "npx",
"args": [
"-y",
"fluxmail"
]
}
}
}
}Add to your Zed `settings.json`.
npx -y fluxmailRun `goose configure`, choose **Add Extension → Command-line Extension**, and paste this command.
评分
39 / 100
不完整
- 文档22/25
- 维护22/25
- 可信度6/20
- 能力0/15
- 安装体验12/15
- Documents what it does and how to connect
- Has a resolvable package or endpoint
- Exposes at least one tool, prompt or resource
- README has substantive content
- Includes a code example
- Documents its configuration
- Mentions credentials or security posture
- Last commit 37 days ago
- Has a release history
- Repository is not archived
- No licence detected
- Namespace verified in the official MCP registry
- Claimed by its owner
- Published under an organisation
- 0 tool(s) documented
- Provides prompt templates
- Provides resources
- 12 documented install method(s)
- Published to a package registry
- Offers a hosted endpoint — no local install
版本历史
| 版本 | 发布于 |
|---|---|
| 0.7.0最新 | 2026年7月25日 |
| 0.6.1 | 2026年7月23日 |
| 0.6.0 | 2026年7月21日 |
| 0.5.0 | 2026年7月18日 |
| 0.4.1 | 2026年7月17日 |
| 0.4.0 | 2026年7月16日 |
| 0.3.0 | 2026年7月14日 |
| 0.2.1 | 2026年7月13日 |