Mr Mail

io.github.GKihlstadiusPublished by GitHub account GKihlstadiusv0.7.1Updated Nov 15, 2026

Local Windows email client with 28 tools: read, draft, send on request, calendar and clean up.

VerifiedSTDIODesktop onlyProductivity & WorkflowCommunication & Collaboration

Overview

AI-generated overview

Built-in MCP server of the Mr Mail Windows email client, letting an agent search, read, draft, schedule and clean up mail and calendar.

What you can do
  • Search, read and summarize mail, including Word and Excel attachments
  • Draft and attach files, sending only when explicitly asked
  • Schedule, snooze, clean up and unsubscribe from senders
  • Read and book calendar events and answer invitations
When to use it
Useful if you run the Mr Mail email client on Windows and want Claude Code, Zed, Cursor or another MCP agent to triage your inbox, draft replies, handle attachments and manage your calendar without leaving the app.
Requirements
Windows only, with the Mr Mail desktop app installed and running; the MCP server is a local stdio process launched from the app's install folder. An email account over IMAP/SMTP (Gmail and Outlook need an app password or OAuth sign-in with your own client id). Optional local HTTP mode on localhost with a bearer token.
Before you install
The agent can send, delete and unsubscribe; by default the app asks for confirmation and agents are told to save drafts, but these permissions can be changed per action. It handles your email credentials and mailbox data, and the app connects directly to your provider. Optional in-app AI features send content to the AI service you choose.

Installation

In SourceWeft

  1. Open Mr Mail in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

[Mr Mail: the email client your AI agent can drive]

[Download] [Stars] [Downloads]

[CI] [MIT license] [Windows 10 and 11] [MCP] [English and Swedish]

A fast, private email client for Windows that Claude Code, Zed and any MCP agent can drive.

Download  ·  Features  ·  AI agents  ·  FAQ  ·  Contribute


[Mr Mail demo]

Why Mr Mail

Your mail stays yours

No 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 agents

A 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 calm

IMAP 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

[Claude Code drafts a reply that opens in Mr Mail]

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):

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 MailA 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.
CalendarGoogle 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.
ContactsEveryone you email, with history, upcoming meetings and one click to write or invite.
Command paletteCtrl+K to jump anywhere, open recent emails, write to a contact or run any action. Ctrl+/ lists every shortcut.
Smart inboxTabs for Personal, Newsletters and Notifications. People you have written to always land in Personal.
Clean UpSee who sends you the most, unsubscribe in one click (RFC 8058), archive or delete everything from a sender, set rules for the future.
Undo everythingUndo send, undo archive and delete (Ctrl+Z), multi select with Ctrl and Shift.
Send later and Remind meSchedule emails, snooze messages, get reminded if nobody replies.
Notifications that do thingsArchive, mark as read or reply straight from the Windows notification.
Templates and signaturesRich 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.
AccountsGmail, Outlook and Microsoft 365, iCloud and any IMAP server. Sign in with Google or Microsoft, or use an app password.
LanguagesEnglish and Swedish, following Windows or your choice.
Auto updateNew releases install with one click from inside the app.

[Clean Up] [Dark mode]

How it compares

Mr MailThunderbirdNew OutlookSpark
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

  1. Download MrMail-Setup-x.y.z.exe from the latest release, or use Scoop: 
    scoop bucket add mr-mail https://github.com/GKihlstadius/mr-mailscoop install mr-mail/mr-mail
  2. Run it. The installer is not code signed yet, so Windows SmartScreen may say it protected your PC: click More info, then Run anyway.
  3. 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 installpnpm start        # build and runpnpm typecheck    # TypeScript and translation checkpnpm 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.5pnpm 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.

[Star history]

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.

Source: README.md at commit c87f1f0

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the package type cannot run in the sandbox.

Version history

1
  1. v0.7.1LatestNov 15, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts