Fluxmail
Give AI agents scoped access to Gmail, Outlook and IMAP mailboxes
- Pricing
- Freemium
- Platforms
- self-hosted, CLI, API
- Runs
- Locally
- Version
- 0.30.0
- Listing updated
- 3 days ago
About Fluxmail
Fluxmail is a freemium MCP server for communication. It runs locally on your machine and is started by your AI client.
Fluxmail separates what each agent may do with a mailbox: one agent can have read-only access while another may send, and either can be revoked from a dashboard. It covers Gmail, Google Workspace, Outlook, Microsoft 365, iCloud, Fastmail and any IMAP/SMTP account.
There are two ways to run it. Fluxmail Cloud is hosted and passes requests through to your provider without keeping a copy of your inbox. The self-hosted package (npm, Node.js 22.22 or newer, or Docker) keeps credentials in a local SQLite database and speaks MCP over stdio or HTTP, plus a REST API and CLI.
The source is available under the Elastic License 2.0. The README says the Personal plan supports three mailboxes and one member without a paid key, while Pro, Business and Enterprise entitlements need a licence key.
Install
Run in a terminal
claude mcp add fluxmail --env GOOGLE_CLIENT_SECRET='<GOOGLE_CLIENT_SECRET>' --env FLUXMAIL_LICENSE_KEY='<FLUXMAIL_LICENSE_KEY>' -- npx -y fluxmailAdd to claude_desktop_config.json
{
"mcpServers": {
"fluxmail": {
"command": "npx",
"args": [
"-y",
"fluxmail"
],
"env": {
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"FLUXMAIL_LICENSE_KEY": "<FLUXMAIL_LICENSE_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"fluxmail": {
"command": "npx",
"args": [
"-y",
"fluxmail"
],
"env": {
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"FLUXMAIL_LICENSE_KEY": "<FLUXMAIL_LICENSE_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"fluxmail": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"fluxmail"
],
"env": {
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"FLUXMAIL_LICENSE_KEY": "<FLUXMAIL_LICENSE_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"fluxmail": {
"command": "npx",
"args": [
"-y",
"fluxmail"
],
"env": {
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"FLUXMAIL_LICENSE_KEY": "<FLUXMAIL_LICENSE_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"fluxmail": {
"command": "npx",
"args": [
"-y",
"fluxmail"
],
"env": {
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"FLUXMAIL_LICENSE_KEY": "<FLUXMAIL_LICENSE_KEY>"
}
}
}
}Configuration
GOOGLE_CLIENT_IDOptional override for Fluxmail's built-in Desktop OAuth client ID.GOOGLE_CLIENT_SECRETClient secret paired with a custom Google OAuth client ID.FLUXMAIL_DATA_DIRDirectory for the Fluxmail database, encryption key, and stored settings.FLUXMAIL_LICENSE_KEYOptional Fluxmail license key for paid plan limits.
What it does
- Per-agent permissions
- Choose read-only, draft or send rights for each agent and revoke them.
- Multiple providers
- Gmail, Outlook, iCloud, Fastmail and any IMAP/SMTP mailbox.
- Attachments and PDFs
- Agents can open attachments and read the text of PDFs.
- Drafts and scheduled sends
- Save drafts for review or let the agent send.
- MCP, REST and CLI
- Self-hosted installs expose all three interfaces.
- Cloud or self-hosted
- Use the hosted service or run it yourself.
Good for
- Summarize overnight email and list what needs a reply
- Pull vendors and totals from receipts for bookkeeping
- Find threads still waiting for an answer and draft reminders
- Archive old newsletters and label mail from the bank
Pricing
Freemium, from $10 a month
Self-hosted Personal plan covers 3 mailboxes; Cloud Pro $120/yr, Business $240/member/yr, 7-day trial
Prices change. Check fluxmail.ai before you buy.
Fluxmail FAQ
Does Cloud store my email?
Per the pricing page, Cloud passes each request through to your provider and does not keep a copy of your inbox.
What does Cloud cost?
Pro is $120 a year for one member and 10 mailboxes; Business is $240 per member a year. Plans start with a 7-day trial.
Can I run it myself?
Yes, via the npm package or a Docker image; mail then stays with your provider and never passes through Fluxmail.
What licence is the source under?
Elastic License 2.0, which is source available rather than OSI open source.
Is Fluxmail free?
Fluxmail has a free plan, with paid plans for more usage or features. Paid plans start at $10 a month.
How do I add Fluxmail to Claude Code?
Run this command in your terminal: claude mcp add fluxmail --env GOOGLE_CLIENT_SECRET='<GOOGLE_CLIENT_SECRET>' --env FLUXMAIL_LICENSE_KEY='<FLUXMAIL_LICENSE_KEY>' -- npx -y fluxmail
What are the best alternatives to Fluxmail?
The closest alternatives to Fluxmail are Ha MCP, Concord MCP, note1, BoardAgent and Callout.
Alternatives to Fluxmail

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media