Claude MarketplacesSubmit

Mail.app

p-l-ta/mail-mcp

Plugs Claude directly into macOS Mail.app via a combination of SQLite queries against the Envelope Index and AppleScript automation. You get search across all configured accounts (iCloud, Exchange, IMAP), full message read access, and write operations like send, reply, flag, move, and trash. The search hits the same database Mail.app uses, so it's fast and works with whatever accounts you've already set up. All processing is local. No network calls, no telemetry. Requires Full Disk Access and Automation permissions for whichever app launches the MCP host. Useful when you want Claude to triage email, draft replies, or surface messages based on complex filters without leaving the conversation.

GitHub stars: 1
tools: 14
transport: STDIO
last updated: Jul 10, 2026

Tools

14 tools

Public tool metadata for what this MCP can expose to an agent.

search_emailsSearch messages via the Envelope Index database with rich filters

Search messages via the Envelope Index database with rich filters

No parameter schema in public metadata yet.

read_emailRead the full body of a message by its RFC message-id

Read the full body of a message by its RFC message-id

No parameter schema in public metadata yet.

list_accounts_and_mailboxesList all configured accounts and mailboxes with unread counts

List all configured accounts and mailboxes with unread counts

No parameter schema in public metadata yet.

list_recentList recent messages in a specific mailbox

List recent messages in a specific mailbox

No parameter schema in public metadata yet.

list_sendersGrouped summary of senders with message and unread counts

Grouped summary of senders with message and unread counts

No parameter schema in public metadata yet.

send_emailSend a new email from one of the configured accounts

Send a new email from one of the configured accounts

No parameter schema in public metadata yet.

reply_to_emailReply to an existing message by RFC message-id

Reply to an existing message by RFC message-id

No parameter schema in public metadata yet.

set_message_flagsSet read and/or flagged status on a message

Set read and/or flagged status on a message

No parameter schema in public metadata yet.

move_emailMove a message to a different mailbox

Move a message to a different mailbox

No parameter schema in public metadata yet.

trash_emailMove a message to Deleted Messages

Move a message to Deleted Messages

No parameter schema in public metadata yet.

create_mailboxCreate a new mailbox/folder in an account

Create a new mailbox/folder in an account

No parameter schema in public metadata yet.

bulk_mark_readMark all messages in a mailbox and/or from a sender as read

Mark all messages in a mailbox and/or from a sender as read

No parameter schema in public metadata yet.

get_unsubscribe_linkExtract unsubscribe URLs from a message's headers and body

Extract unsubscribe URLs from a message's headers and body

No parameter schema in public metadata yet.

empty_mailboxDelete every message in a mailbox at once (Junk, Trash, etc.)

Delete every message in a mailbox at once (Junk, Trash, etc.)

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthly Promote your product hereReach 125k+ visitors monthly

Agent CaffeineSponsoredClose your lid, come back to finished work

SnugSponsoredThe clipboard manager for the AI era Promote your product hereReach 125k+ visitors monthly

WaxSponsoredBlock anything with supervision, without erasing your iPhone Promote your product hereReach 125k+ visitors monthly

knobsSponsoredSee your site on any phone, any day, in any language

Readme

mail-mcp

MCP server that gives Claude (and other MCP hosts) full access to Mail.app on macOS — search, read, send, reply, flag, move, and more — across every account configured in Mail.app (iCloud, Exchange, IMAP, etc.).

Prerequisites

macOS (Mail.app required)
Node.js 20+
An MCP host: Claude Desktop, Amazon Quick, or any stdio MCP client

Installation

Claude Desktop — one-click install (recommended)

Download mail-mcp.mcpb from the latest release
Double-click the .mcpb file — Claude Desktop installs it automatically
Grant the required macOS permissions (see below)

Manual / Amazon Quick / other hosts

npx @p-l-ta/mail-mcp

Or install globally:

npm install -g @p-l-ta/mail-mcp
mail-mcp

Point your MCP host at the mail-mcp binary (stdio transport). Example config:

{
  "mcpServers": {
    "mail-app": {
      "command": "npx",
      "args": ["@p-l-ta/mail-mcp"]
    }
  }
}

Required macOS permissions

Grant these to the application that runs the MCP host (Claude Desktop, Amazon Quick, etc.):

View the full README on GitHub

Details

Repository: github.com/p-l-ta/mail-mcp
Categories: Communication & Messaging, Search & Web Crawling
Package: @p-l-ta/mail-mcp
Transport: STDIO
Registry: MCP registry, active

More from p-l-ta

Calendar.app

Related Communication & Messaging MCP servers

1

ProdPokeprodpoke/prodpoke-mcpAI QA tester — real browsers scan sites for bugs, SEO, perf, and accessibility issues via chat.1stars

2

Meshimize Mcprenl/meshimize-mcpMeshimize: Q&A groups, messaging, group discovery, and agent-to-agent delegation1stars

3

Claude Armyrobbhimself-1337/claude-armyOrchestrate multiple Claude Code agents in parallel from chat1stars

4

Memory OS AIromainsantoli-web/memory-os-aiAdaptive memory for AI agents — FAISS search, chat extraction, cross-project linking1stars

5

Sports Betting Mcpseang1121/sports-betting-mcpAI sports betting picks, odds, injuries & line movement. 1,353+ picks, 59.6% win rate.1stars

6

voximplant-mcptheyahia/voximplant-mcpMCP server for Voximplant — cloud telephony, call history, SMS (Russia)1stars