MyMailForAI

MyMailForAI

Your own mailbox, with full access for your AI agent, and the brake in the menu bar.

Installation

Install via Homebrew tap and authenticate your email account:

$ brew install --cask nspxmiguel/tap/mymailforai $ mymailforai login voce@gmail.com

MailForAI vs MyMailForAI

Feature MailForAI MyMailForAI
Mailbox Agent's mailbox (claude@nspx.dev) Your own (Gmail, iCloud, etc.)
Scope Send to allowlist only Read all, write, move, archive
Interface Windowed app with tabs & assistant Menu bar item only
Brake Allowlist + daily limit Mode (automatic / ask / read-only)
Accounts One As many as you want, with logout

One mailbox, several addresses

An iCloud account is not an address — it is a mailbox that receives on several: the Apple ID, the @icloud.com ones, your own domain, the Hide My Email aliases. They all land in the same inbox, so connecting each as a separate account would show you the same mail three times. What actually differs is which address the message goes out as.

proven

The address appears in the From: of something in your Sent folder. The server has already accepted sending as it — that is history, not a guess.

receives

The address appears in the To: of mail that arrived. It proves the mailbox receives on it, which is not the same as being allowed to send from it.

$ mymailforai identities $ mymailforai identities --send-as you@yourdomain.com

Replies pick the identity on their own: a message that arrived for you@yourdomain.com is answered from you@yourdomain.com, not from whichever address you happened to log in with.

What the agent sees

A mailbox that receives on several addresses is also, unavoidably, one IMAP connection. Opening "the agent's mailbox" and opening your personal mail are the same connection, so without a limit the very first listing hands the agent fifteen hundred messages that were never meant for it. Every account is created scoped to the address you connected with.

$ mymailforai scope $ mymailforai scope --all

The limit holds on both sides: the server-side search is filtered before results exist, and reading by UID checks again — a UID can come from anywhere, including a guess.

Execution Modes

auto (Automatic)

Read access is fully enabled, and all email sending or writing actions execute immediately.

ask (Ask Permission — Default)

Read access is fully enabled; write actions enter the queue and await approval in the menu bar.

read (Read-Only)

Read access is fully enabled, but any write or modification attempt is rejected with a clear explanation.

Privacy & Security

Your app password goes directly into the macOS Keychain. Nothing ever leaves your machine, and there is no server of ours.

MCP Tools

When launched with mymailforai mcp, the following Model Context Protocol tools are exposed over stdio:

list_accounts List configured accounts, default account, and status.
mailbox_status Check inbox summary and unread mail counts.
list_folders List all folders in the mailbox.
list_inbox List recent messages from the inbox.
search_email Search emails by sender, recipient, subject, text, or date.
read_email Read complete message content and headers by UID.
download_attachment Save email attachments on demand to local disk.
send_email Send a new email message.
reply_email Reply to an existing email thread.
forward_email Forward an email to specified recipients.
save_draft Save a draft message without sending.
mark_email Mark emails as read, unread, starred, or unstarred.
move_email Move messages to a specified folder.
archive_email Move messages to the Archive folder.
trash_email Safely move messages to the Trash folder.
list_pending List actions in the queue waiting for approval.