Your agent asks. You decide.

email-mcp connects an AI agent, such as Claude Code, to your email. The agent can read, organize and write mail. By default, every send waits until you approve it.

The approval page of email-mcp, drawn with sample data.
On your computer
email-mcp runs on your computer. It stores your mail passwords there, encrypted.
Works with IMAP and SMTP
IMAP reads mail and SMTP sends it. You connect with a password or an app password.
Your rules
For each account, you choose how far the agent may go.

How it works

Your AI app can use tools that other programs offer. MCP (Model Context Protocol) is the open standard for this. email-mcp is an MCP server: a program that offers email tools to your AI app.

  1. 1 Connect your mail.

    Add an account in your browser, with your address and a password. email-mcp tests the connection and saves the account only when the test passes.

  2. 2 Add email-mcp to your AI app.

    You do this once. After that, your agent can use the email tools.

  3. 3 Ask your agent.

    Use plain words. For example, you can type: “Find Anna’s message about Thursday and reply that 10:00 works.” The agent uses the email tools to search, read, organize, write drafts and send.

  4. 4 Decide.

    By default, email-mcp holds each send until you approve it. You see the message first.

You choose how far each account may go

Each mail account has its own level. A higher level includes the levels below it.

0 Off
The agent cannot use the account.
1 Read
Search and read messages and attachments.
2 Organize
Mark as read, flag, tag, make folders and move messages. These moves, and new folders, never go into a folder that email-mcp recognizes as the Trash, or into a folder inside that folder.
3 Draft
Write drafts, and move a draft to the Trash. Moving a draft does not ask you.
4 Send
Send, reply and forward. A new account starts here. By default, every send asks you first.
5 Delete
Move messages to the Trash. By default, each of these moves asks you first. email-mcp has no tool that deletes mail for good.

Only you can change a level, on a page in your browser. The agent has no tool for this. It can ask for more access. That only gives you a link to the settings page, and nothing changes until you choose. The manual page Security says when this holds.

You see the message before you decide

By default, email-mcp holds a message when your agent wants to send it. On the approval page, you see who will get it, including hidden copies (Bcc), the subject, the attachments and the whole text of the message. If the text of the message also has characters that cannot be seen, the page says so. The page shows the message as plain text: the text that a mail program would show. The page lists each attachment by name and type. Then you press Reject or Approve and send.

  • Approve and send appears only when the page can show the whole text of the message.
  • If the message changes after you look at it, it does not go out.
  • After you decide, the page tells you what happened. It says Sent only when the mail server accepted the message.
  • If you do nothing, the request expires and nothing is sent.

Some AI apps can ask you in their own window. There, email-mcp shows the start of the text, and says how much of it is not shown. For the others, your agent gives you a link to the approval page.

You can turn this question off for an account. email-mcp then asks you to tick a box that accepts the risk. Limits still apply when it is off: sends per hour and per day, and recipients per message.

email-mcp runs on your computer

Passwords
Stored on your computer, encrypted with AES-256-GCM (a standard encryption method). By default, the key that protects them is in the keychain (the password store) of your operating system.
Your mail
email-mcp does not keep a copy of your mailbox. Your messages stay on your mail server.
Web pages
The approval page and the settings pages run only on your computer, at email-mcp.localhost, a name that Chrome, Edge and Firefox send to your own computer.
Activity
Every tool call of your agent is written to an Activity page that you can read. The log never stores message bodies or attachment data.
What your agent reads
When your agent reads a message, the text goes to your AI app. What that app does with it is up to the app.

What it covers today

Mail only
This release covers mail. Calendar and contacts are planned.
Google and Microsoft
Sign-in on the Google or Microsoft website (OAuth) is planned. Until then, connect these accounts with an app password: a separate password that you make in the security settings of your mail account. Your provider must offer app passwords.
AI apps
The manual shows the setup for Claude Code, Claude Desktop, Cursor, VS Code and the Codex CLI.
Systems
Release builds exist for macOS, Linux and Windows.
Open source
email-mcp is open source under the MIT license: you may use, copy and change the code. You can read it on GitHub.

Start with the manual

The manual shows you how to install email-mcp, connect an account and add it to your AI app.

For developers: Read the tech docs or see the code on GitHub.