Fluxmail MCP Server
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. It runs locally over stdio via the published package.
People connecting email tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.
VERIFIED ACTIVE
LAST COMMIT 2026-07-25 · ★ 2 · #36 OF 75 MAINTAINED EMAIL · VERIFIED 2026-08-25
NOASSERTION · TypeScript servers · how we verify → /methodology
01 · Install Fluxmail
Claude Code
claude mcp add churichard-fluxmail -- npx -y fluxmail Claude Desktop / Cursor / VS Code - add to config
{
"mcpServers": {
"churichard-fluxmail": {
"command": "npx",
"args": [
"-y",
"fluxmail"
]
}
}
} Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.
Using another client? Same JSON, different key
Claude Desktop · mcpServers
Cursor · mcpServers
VS Code · servers
Windsurf · mcpServers
Zed · context_servers
Cline · mcpServers
Roo Code · mcpServers
Continue · mcpServers
LibreChat · mcpServers
Gemini CLI · mcpServers
Codex CLI · mcp_servers
Full setup guides: every client.
02 · Evidence
Security posture
What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.
runs as local process (stdio) - runs on your machine with your user's permissions
repo age created 2026-07-09 - young repo, little track record yet
license no standard license detected - usage rights unclear; check the repo before commercial use
npm package fluxmail - unscoped; check the name against the project README before installing
registry namespace io.github.churichard is GitHub-verified and matches the repo owner
03 · What Fluxmail can do
Prose above is summarized from the project's README and registry record - no invented capabilities.
Latest releases
v0.7.0 · 2026-07-25
Only the breaking entries for the interfaces you use apply. An MCP-only integration, for example, does not need the CLI or REST migrations. · Changed · [CLI] Breaking: CLI users must replace --unread-only with --read…
v0.6.1 · 2026-07-23
Fixed · Stop local IMAP CLI commands from hanging after completion (#72)
v0.6.0 · 2026-07-21
Changed · replace config.env and automatic working-directory dotenv loading with typed config.toml deployment settings and encrypted OAuth and license records in SQLite; back up the data directory and migrate existing…
04 · Who maintains Fluxmail
Fluxmail is maintained by churichard. It's the only MCP server we track from this author; the repo dates to Jul 2026.
05 · Facts
- repository
- github.com/churichard/fluxmail
- website
- https://fluxmail.ai/
- category
- email - ranked #36 of 75 actively-maintained email servers as of 2026-08-25.
- release cadence
- 10+ releases in the last 90 days (latest 2026-07-25)
- registry
- io.github.churichard/fluxmail (active, first published 2026-07-13 · 8 versions)
- packages
- npm:fluxmail
06 · Fluxmail FAQ
What is 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. It runs locally over stdio via the published package.
Is Fluxmail still maintained?
Yes - as of 2026-08-25, its last commit was 2026-07-25 and it shipped 10+ releases in the last 90 days. We re-verify nightly.
How do I install Fluxmail?
Run `npx -y fluxmail`. You can also paste the ready-made client config above.
Does Fluxmail run locally?
Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.
07 · Alternatives to Fluxmail
Alternatives to Fluxmail
Maintained email servers if Fluxmail isn't the fit.
- Emailmd Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails. ★ 1,303 · 2026-08-15
- Sessy - Amazon SES observability Read-only Amazon SES observability: search events, inspect bounces, pull delivery stats. ★ 914 · 2026-08-18
- Mu News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint. ★ 387 · 2026-08-24
- Hqbase Connect AI agents to your self-hosted HQBase shared email workspace. ★ 295 · 2026-08-25
- SendGrid MCP server for SendGrid - global transactional + marketing email (Twilio-owned) ★ 269 · 2026-08-12
- Atomic Mail Programmable email inbox for AI agents - JMAP, PoW auth, stdio MCP server. ★ 266 · 2026-08-11
More email MCP servers · Email MCP · Google Workspace MCP Server · Mail Muncher · Mailbridge
More TypeScript MCP servers · Churnkey · Pipedrive CRM · Clari Layer · Clawcall · Pumpclaw · see all