EasyMail Pro

Model Context Protocol ? EasyMail Pro v1.2.1+

Give your AI agent direct, local access to your email.

EasyMail Pro ships with a built-in MCP server on 127.0.0.1. Connect Claude Desktop, Claude Code, OpenAI Codex, OpenCode, Cursor or VS Code straight to your mailbox ? zero cloud relay, zero third-party OAuth, and read-only by default.

What is EasyMail Pro?

A fast, private desktop email app ? free for Windows, macOS and Linux.

EasyMail Pro brings Gmail, Outlook, Microsoft 365, iCloud, Yahoo and any IMAP account into one local inbox on your computer. It includes Split Inbox, instant offline search, snooze, undo send, reusable templates, one-click sign-in code copy and optional AI on your own API key ? with no EasyMail account, no ads and no cloud server between you and your mail.

Explore EasyMail ProClick here to see all features, screenshots and downloads.

Connect in under a minute.

Turn the server on inside EasyMail Pro, copy your personal Bearer token, and paste the snippet for your client.

  1. 01

    Enable in Settings

    Open EasyMail Pro (v1.2.1 or newer) and go to Settings ? MCP Server.

  2. 02

    Choose access mode

    Start in Read-only (default) or switch to Read and write (Full access) whenever you want your agent to draft, organise or send.

  3. 03

    Copy your Bearer token

    Paste your token into any client below ? direct Streamable HTTP or the @easymailpro/mcp stdio bridge.

Claude Desktop

claude_desktop_config.jsonstdio bridge (@easymailpro/mcp)
{
  "mcpServers": {
    "easymailpro": {
      "command": "npx",
      "args": ["-y", "@easymailpro/mcp"],
      "env": {
        "EASYMAIL_MCP_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}

Uses the official zero-dependency npm bridge over stdio. Add EASYMAIL_MCP_URL if you changed the default port (41280).

Claude Code

TerminalDirect Streamable HTTP
claude mcp add --transport http --scope user easymailpro http://127.0.0.1:41280/mcp   --header "Authorization: Bearer YOUR_TOKEN_HERE"

Connects straight to EasyMail Pro on 127.0.0.1 with no bridge required. --scope user makes it available across all projects.

OpenAI Codex

~/.codex/config.tomlDirect Streamable HTTP
[mcp_servers.easymailpro]
url = "http://127.0.0.1:41280/mcp"

[mcp_servers.easymailpro.http_headers]
Authorization = "Bearer YOUR_TOKEN_HERE"

Add to your Codex config file to connect directly to the local EasyMail Pro server.

OpenCode

opencode.jsonDirect Streamable HTTP
{
  "mcp": {
    "easymailpro": {
      "type": "remote",
      "url": "http://127.0.0.1:41280/mcp",
      "oauth": false,
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Set oauth to false so OpenCode sends your local Bearer header straight to EasyMail Pro.

Cursor

~/.cursor/mcp.jsonDirect Streamable HTTP
{
  "mcpServers": {
    "easymailpro": {
      "url": "http://127.0.0.1:41280/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}

Works in Cursor, VS Code, Windsurf, Cline and any client supporting Streamable HTTP or the @easymailpro/mcp stdio bridge.

Two clear access modes. Zero cloud relay.

No confusing per-tool matrix. Either your agent can only read and search, or you grant full read and write access ? and every guardrail stays enforced locally.

Read-only

Default ? 14 tools

Search with local FTS5, read threads and messages, extract text from PDF/Word/Excel/CSV attachments, inspect accounts, folders, drafts, VIPs, templates and follow-ups, and trigger an IMAP sync.

All 14 write tools are omitted from tools/list and rejected immediately if invoked.

Read and write (Full access)

Opt-in ? All 28 tools

Adds drafting, sending and scheduled send, archive, trash, spam, move, snooze, mark read/unread, star, custom folder management, VIPs, Split Inbox category rules, templates and follow-up dismissal.

Switch back to Read-only at any time ? write access is revoked immediately without reconnecting.

Loopback only (127.0.0.1)

Listens strictly on localhost. Requests carrying a browser Origin header or a non-loopback Host header are rejected with 403 Forbidden.

Encrypted vault token

Authenticated with a per-install Bearer token stored in EasyMail Pro's encrypted vault and checked in constant time (401 on mismatch).

Destructive guardrails

Permanently expunging Trash, deleting built-in folders (Inbox, Sent, Trash) and deleting non-empty folders are always refused ? even in Full access.

Bounded & prompt-safe

Bulk mutations cap at 100 messages per call, and untrusted email and attachment bodies are wrapped in <email_content> and <attachment_content> delimiters.

28 tools, 5 resources, 3 prompts.

Implements MCP Streamable HTTP (2025-03-26 through 2025-11-25 initialize plus 2026-07-28 server/discover), ToolAnnotations and structuredContent.

Read-only tools

14
list_accounts
List configured accounts, display names, signatures and unread counts.
list_folders
List mailbox folders and unread counts across one or all accounts.
list_threads
Paginate threads in a folder with optional Split Inbox tab or quick filter.
search_emails
Full-text local FTS5 search with from:, to:, subject:, has:attachment, is:unread, is:starred.
get_thread
Read every message in a thread with headers, plain-text bodies and attachment metadata.
get_message
Read a single message with headers, body text and attachments.
read_attachment
Extract plain text from cached PDF, Word (.docx), Excel (.xlsx) and text/CSV/JSON files.
list_drafts
List local and synced drafts.
list_scheduled
List messages queued for scheduled send.
list_templates
List saved reply templates and /shortcut triggers.
list_vips
List VIP email senders.
get_sender_overview
Inspect a sender's VIP status, Split Inbox tab, message count, recent mail and attachments.
list_followups
Find sent threads still waiting on a reply after a chosen number of days.
sync_now
Trigger an immediate IMAP sync for one account or all accounts.

Write tools (Full access)

14
create_draft
Create a new draft, reply draft or forward draft without sending.
update_draft
Edit recipients, subject or body on an existing draft.
delete_draft
Discard an existing draft.
send_email
Send immediately via SMTP or schedule for a future timestamp (from a draft or inline).
cancel_scheduled
Cancel a scheduled email and return it to Drafts.
manage_emails
Batch up to 100 emails: archive, trash, spam, move, mark read/unread, star/unstar.
snooze_emails
Snooze one or more emails until a future Unix timestamp.
unsnooze_emails
Return snoozed emails to the inbox immediately.
manage_folder
Create, rename or delete a custom folder (built-in and non-empty folders are protected).
set_vip
Mark or unmark an address as a VIP sender.
set_sender_category
Assign a sender to Primary, Shopping or Marketing in Split Inbox.
save_template
Create or update a reusable email template.
delete_template
Delete a saved email template.
dismiss_followup
Dismiss a sent thread from the Follow-ups list.

Resources

5
easymail://accounts
All configured mailboxes with unread counts.
easymail://folders
Folder hierarchy across every connected account.
easymail://templates
Saved reply templates and shortcuts.
easymail://thread/{id}
Full conversation view for a thread ID.
easymail://message/{id}
Single message payload for a message ID.

Prompts

3
triage_inbox
Review unread mail, prioritise what matters and surface action items.
draft_reply
Draft a contextual reply grounded in the full thread history.
daily_briefing
Summarise today's inbox, VIP messages and threads awaiting follow-up.

Ready to connect your inbox?

Download EasyMail Pro free for Windows, macOS and Linux, or head to the main page to see everything else it does.