
mr-mail
io.github.GKihlstadius/mr-mail
Local Windows email client with 28 tools: read, draft, send on request, calendar and clean up.
Documentation
A fast, private email client for Windows that Claude Code, Zed and any MCP agent can drive.
Download · Features · AI agents · FAQ · Contribute
Why Mr Mail
Your mail stays yoursNo account, no cloud sync, no tracking. Mr Mail talks IMAP and SMTP straight to your provider and keeps everything on your computer. Passwords are encrypted by Windows, remote images are blocked until you allow them. |
Built for AI agentsA built in MCP server with 28 tools. Your agent can search, read, summarize, draft, attach files, read Word and Excel attachments, schedule, clean up, answer invitations and read and book your calendar. It never sends unless you ask. |
Fast and calmIMAP IDLE for instant mail, a local SQLite cache and a list that stays smooth with tens of thousands of emails. A clean design in the spirit of Apple Mail, in light and dark. |
Let your AI agent handle email
Install Mr Mail, open Settings, Control with AI tools and click Connect next to your agent. Mr Mail adds itself to the agent's config and keeps your other settings and comments intact.
One click for: Claude Desktop, Claude Code, Cursor, VS Code (Copilot), Windsurf, Zed, Gemini CLI, LM Studio and Codex CLI. Claude Desktop users can also double click MrMail-x.y.z.mcpb from the latest release.
Manual setup (Claude Code, Zed, any MCP client)
Claude Code:
claude mcp add mr-mail --scope user -e ELECTRON_RUN_AS_NODE=1 -- "%LOCALAPPDATA%\Programs\mr-mail\MrMail.exe" "%LOCALAPPDATA%\Programs\mr-mail\resources\mr-mail-mcp.cjs"
Zed (settings.json):
"context_servers": {
"mr-mail": {
"source": "custom",
"command": "C:\\Users\\<you>\\AppData\\Local\\Programs\\mr-mail\\MrMail.exe",
"args": ["C:\\Users\\<you>\\AppData\\Local\\Programs\\mr-mail\\resources\\mr-mail-mcp.cjs"],
"env": { "ELECTRON_RUN_AS_NODE": "1" }
}
}
Any stdio client: run MrMail.exe with ELECTRON_RUN_AS_NODE=1 and the path to resources\mr-mail-mcp.cjs as its only argument.
Clients that only take a URL: turn on Accept connections over HTTP in Settings and use http://127.0.0.1:7337/mcp with the bearer token shown there (MCP Streamable HTTP, localhost only).
Then just ask:
"Summarize what came in today and draft a reply to Karin saying Tuesday at 2 works."
"Save the attachment from Sam to Downloads, then reply to all with the edited image attached."
"Unsubscribe me from every newsletter I have not opened in three months."
"Find a free hour with Jonas next week and send him an invite."
Safe by design. Agents never send unless you explicitly asked; otherwise they save a draft that opens in the app for you to review. You choose per action whether sending, deleting and unsubscribing is allowed, asks you first (the default) or is never allowed, and an activity log shows every call an agent made. New tools show up in your agent automatically after an app update. Full tool list: docs/mcp.md.
Features
| Ask Mr Mail | A chat panel (Ctrl+J) that searches, reads, drafts and books for you with the same tools and permissions as your agents. Works with ChatGPT, a local model or your own server. |
| Calendar | Google Calendar, Outlook and iCloud or any CalDAV server. A calm agenda view, create and edit events, find free time, answer invitations with Yes, Maybe or No right in the email. |
| Contacts | Everyone you email, with history, upcoming meetings and one click to write or invite. |
| Command palette | Ctrl+K to jump anywhere, open recent emails, write to a contact or run any action. Ctrl+/ lists every shortcut. |
| Smart inbox | Tabs for Personal, Newsletters and Notifications. People you have written to always land in Personal. |
| Clean Up | See who sends you the most, unsubscribe in one click (RFC 8058), archive or delete everything from a sender, set rules for the future. |
| Undo everything | Undo send, undo archive and delete (Ctrl+Z), multi select with Ctrl and Shift. |
| Send later and Remind me | Schedule emails, snooze messages, get reminded if nobody replies. |
| Notifications that do things | Archive, mark as read or reply straight from the Windows notification. |
| Templates and signatures | Rich text signatures per account, reusable templates, import signatures from Spark. |
| AI in the app (optional) | Suggested replies, summaries and to dos with ChatGPT, Claude, a local model or your own OpenAI compatible server. AI in the app only ever writes drafts. |
| Accounts | Gmail, Outlook and Microsoft 365, iCloud and any IMAP server. Sign in with Google or Microsoft, or use an app password. |
| Languages | English and Swedish, following Windows or your choice. |
| Auto update | New releases install with one click from inside the app. |
How it compares
| Mr Mail | Thunderbird | New Outlook | Spark | |
|---|---|---|---|---|
| Free | ✓ | ✓ | ✓ | Freemium |
| Open source | ✓ | ✓ | ||
| Mail goes only between you and your provider | ✓ | ✓ | ||
| Built in MCP server for AI agents | ✓ | |||
| One click setup for Claude, Cursor, VS Code and more | ✓ | |||
| Smart inbox that puts people first | ✓ | ✓ | ✓ |
New Outlook syncs non Microsoft accounts through Microsoft's cloud, and Spark stores account access on its own servers to deliver push and team features.
Install
- Download
MrMail-Setup-x.y.z.exefrom the latest release, or use Scoop:scoop bucket add mr-mail https://github.com/GKihlstadius/mr-mail scoop install mr-mail/mr-mail - Run it. The installer is not code signed yet, so Windows SmartScreen may say it protected your PC: click More info, then Run anyway.
- Add your account. Mr Mail finds the server settings for most providers automatically.
Mr Mail updates itself. The only thing it sends anywhere besides your own mail servers is a version check against the GitHub API, plus requests to the AI service you choose, if you turn AI on.
FAQ
Does my email pass through any server of yours?
No. There is no Mr Mail server. The app connects directly to your provider over IMAP and SMTP. Your cache lives in a SQLite file under %APPDATA%.
What does an AI agent see?
Only what it asks for through the MCP tools, while the app is running on your computer. The MCP server talks to the app over localhost with a random token. Nothing is uploaded unless your agent itself sends it to its model.
Can an agent send email without asking me?
No. By default Mr Mail asks you in a dialog before anything is sent, deleted or unsubscribed, whichever agent asked. You can change that per action under Settings, Control with AI tools, and see every call in the activity log there. Agents are also told to save drafts unless you explicitly ask them to send.
Gmail says my password is wrong.
Gmail and Outlook need either an app password or sign in with Google or Microsoft. Sign in needs your own free OAuth client id, see docs/oauth.md.
macOS or Linux?
Not yet. The code is plain Electron and should port well; pull requests are welcome.
Build from source
Requires Node 24 or newer, pnpm 10 and Windows.
pnpm install
pnpm start # build and run
pnpm typecheck # TypeScript and translation check
pnpm test # unit tests (IMAP tests run when GreenMail is up)
pnpm dist # installer in release/
Integration and end to end tests run against GreenMail in Docker, never against real accounts:
docker run -d --name mr-mail-greenmail --cpus 1 -p 3025:3025 -p 3143:3143 -e GREENMAIL_OPTS="-Dgreenmail.setup.test.all -Dgreenmail.hostname=0.0.0.0 -Dgreenmail.auth.disabled" greenmail/standalone:2.1.5
pnpm build && pnpm test:e2e
Stack: Electron, React, TypeScript, imapflow, nodemailer, mailparser, node:sqlite, DOMPurify. No UI framework, about 21 000 lines. See CONTRIBUTING.md to get started.
Roadmap
- MCP server with drafts, attachments, scheduling and clean up
- English and Swedish
- Auto update from GitHub Releases
- Calendar: Google, Outlook, iCloud and CalDAV, invitations in the reader
- One click setup for AI clients, MCP over HTTP, Claude Desktop extension
- Chat in the app, contacts, command palette
- Code signed installer
- winget (submitted)
- More languages (translations are one file per language, see CONTRIBUTING.md)
- macOS build
Have an idea? Open an issue.
Support the project
Mr Mail is free and MIT licensed. If it saves you time, you can buy me a coffee:
- Crypto (BNB Smart Chain, Ethereum or any EVM chain):
0x9869799157186227bA3Cc980bAE3C64E022453a0
A star helps more people find it. Bug reports and pull requests help just as much.
På svenska
Mr Mail är en snabb och privat mejlklient för Windows, på svenska och engelska. Den pratar direkt med din mejlserver, sparar allt på datorn och låter AI-verktyg som Claude Code läsa, sortera och skriva utkast åt dig. Ladda ned den senaste versionen under Releases.
License
MIT. The mascot and icon are original artwork for this project.
https://github.com/GKihlstadius/mr-mail/releases/download/v0.7.1/MrMail-0.7.1.mcpb# mcpb: https://github.com/GKihlstadius/mr-mail/releases/download/v0.7.1/MrMail-0.7.1.mcpb