---
title: "MCP Server ? EasyMail Pro"
description: "Connect Claude, Codex, OpenCode and Cursor to your local EasyMail Pro inbox over MCP. Zero cloud relay, 28 tools, read-only by default."
url: "https://easymailpro.tech/mcp"
---

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.

[Download](https://easymailpro.tech/#download) [Setup guide](https://easymailpro.tech/mcp#setup)

Official Registry ID

tech.easymailpro/easymailpro

npm bridge (stdio)

npx -y @easymailpro/mcp

Zero dependencies. Or connect directly over Streamable HTTP on 127.0.0.1:41280/mcp.

Capabilities & links

28 tools ? 5 resources ? 3 prompts

- [GitHub ](https://github.com/mdsolutionsdk/easymailpro-mcp)
- [npm ](https://www.npmjs.com/package/@easymailpro/mcp)
- [MCP Registry ](https://registry.modelcontextprotocol.io/v0.1/servers?search=tech.easymailpro/easymailpro)

![](https://easymailpro.tech/icon.png)

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 Pro](https://easymailpro.tech/) Click 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.json stdio 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

Terminal Direct 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.toml Direct 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.json Direct 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.json Direct 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.

[Download](https://easymailpro.tech/#download) [See all features](https://easymailpro.tech/)
