Fluxmail — Claude Code MCP server: what it does, how to install
Self-hosted email backend connecting mailboxes to AI agents via MCP. Useful for reading incoming mail, preparing drafts, and sending replies.
claude mcp add --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --env FLUXMAIL_DATA_DIR=<FLUXMAIL_DATA_DIR> --env FLUXMAIL_LICENSE_KEY=<FLUXMAIL_LICENSE_KEY> --transport stdio server -- npx -y fluxmailWhat Fluxmail does
Fluxmail connects mailboxes directly to autonomous coding assistants using MCP or HTTP. It handles Gmail, Microsoft 365, Outlook.com, and standard IMAP or SMTP accounts. Agents gain tools to inspect threads, compose drafts, and trigger sends.
Developers control the service with the bundled CLI or integrate web applications via its REST API. Local execution uses stdio, while containerized setups rely on streamable HTTP. Node.js 22.22 or newer is required. The free Personal plan caps usage at three mailboxes for one user, requiring an upgraded key for larger workloads.
What it helps with
- search and read incoming emails across Gmail, Outlook, and IMAP accounts
- prepare draft responses and send outbound messages from the agent interface
- sort and organize message folders directly within autonomous workflows
Example prompts for the agent
- Check the latest unread emails in my Gmail inbox from today
- Draft a reply to the newest email from the client
- Search Outlook messages for unread invoices received last week
How to install Fluxmail
Platform CLI
claude mcp add --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --env FLUXMAIL_DATA_DIR=<FLUXMAIL_DATA_DIR> --env FLUXMAIL_LICENSE_KEY=<FLUXMAIL_LICENSE_KEY> --transport stdio server -- npx -y fluxmailReplace <…> with your own values
Platform CLI
codex mcp add server --env GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> --env GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> --env FLUXMAIL_DATA_DIR=<FLUXMAIL_DATA_DIR> --env FLUXMAIL_LICENSE_KEY=<FLUXMAIL_LICENSE_KEY> -- npx -y fluxmailReplace <…> with your own values
Config file
{
"mcpServers": {
"server": {
"command": "npx",
"args": [
"-y",
"fluxmail"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"FLUXMAIL_DATA_DIR": "<FLUXMAIL_DATA_DIR>",
"FLUXMAIL_LICENSE_KEY": "<FLUXMAIL_LICENSE_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"fluxmail"
],
"env": {
"GOOGLE_CLIENT_ID": "<GOOGLE_CLIENT_ID>",
"GOOGLE_CLIENT_SECRET": "<GOOGLE_CLIENT_SECRET>",
"FLUXMAIL_DATA_DIR": "<FLUXMAIL_DATA_DIR>",
"FLUXMAIL_LICENSE_KEY": "<FLUXMAIL_LICENSE_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e GOOGLE_CLIENT_ID=<GOOGLE_CLIENT_ID> -e GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> -e FLUXMAIL_DATA_DIR=<FLUXMAIL_DATA_DIR> -e FLUXMAIL_LICENSE_KEY=<FLUXMAIL_LICENSE_KEY> server npx -y fluxmailReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Fluxmail
How to install Fluxmail in Claude Code?
Add the server by running claude mcp add fluxmail -e GOOGLE_CLIENT_SECRET=<GOOGLE_CLIENT_SECRET> -e FLUXMAIL_LICENSE_KEY=<FLUXMAIL_LICENSE_KEY> -- npx -y fluxmail. Replace the placeholders with your actual keys.
Which email providers can Fluxmail connect to?
It connects to Gmail, Outlook.com, Microsoft 365, as well as generic mailboxes using standard IMAP and SMTP protocols.
Is a paid license required to use Fluxmail?
The Personal tier works without payment for one member and up to three mailboxes. Commercial tiers like Pro or Enterprise require a separate license key.
