redpop avatar

Apple Mail

redpop/apple-mail-mcp

Search and read Apple Mail on macOS, read-only: mailboxes, messages and threads.

tools
4
transport
STDIO
last updated
Nov 12, 2026

Tools

4 tools

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

list_mailboxesAccounts and visible mailboxes with total and unread counts and a role (inbox, sent, junk, ...).

Accounts and visible mailboxes with total and unread counts and a role (inbox, sent, junk, ...).

No parameter schema in public metadata yet.

search_messagesNewest-first search by sender, recipient, subject, free text, mailbox, dates, unread, flagged, attachment, and optionally body text. Paginated with a cursor.

Newest-first search by sender, recipient, subject, free text, mailbox, dates, unread, flagged, attachment, and optionally body text. Paginated with a cursor.

No parameter schema in public metadata yet.

get_messageOne message: headers, attachment names, body as plain text, optional removal of quoted replies.

One message: headers, attachment names, body as plain text, optional removal of quoted replies.

No parameter schema in public metadata yet.

get_threadThe messages of one conversation, oldest first, without bodies.

The messages of one conversation, oldest first, without bodies.

No parameter schema in public metadata yet.

Sponsors

Readme

apple-mail-mcp

A read-only MCP server that lets an AI assistant search and read the mail in Apple Mail.

macOS only. It reads the local index that Mail.app keeps on your Mac.

claude mcp add apple-mail -- npx -y @redpop/apple-mail-mcp

Then grant Full Disk Access once with npx -y @redpop/apple-mail-mcp setup. For Claude Desktop there is a one-click bundle: see Install.

What it does

The main use is "find the mail about X":

"Find the mail from the landlord about the heating bill"
"What did Anna send me last week with an attachment?"
"Show the whole thread about the contract renewal"

Four tools: list_mailboxes, search_messages, get_message, get_thread. Search covers sender, recipient, subject, free text, mailbox, date range, unread, flagged and attachments, and can also look inside message bodies. Results carry a message:// link that opens the mail in Mail.app, where Mail stores the Message-ID (not on macOS 15). Details: docs/tools.md.

Why this one


View the full README on GitHub

Details

Repository
github.com/redpop/apple-mail-mcp
Category
Search & Web Crawling
Package
@redpop/apple-mail-mcp
Transport
STDIO
Registry
MCP registry, active

Related Search & Web Crawling MCP servers

View all
1robertalsop avatarUK Companies Houserobertalsop/bartram_foundryUK Companies House with cleaning - 12 tools for search, profiles, officers, PSCs, filings, and more.0stars
2rog0x avatarNpmrog0x/mcp-npm-toolsnpm package search, audit, bundle analysis for AI agents0stars
3rsweeting1 avatarPixelvaultrsweeting1/pixelvault-mcpAI-native marketplace for pre-cleared licensed media assets — search, license, and stream rights.0stars
4sdmcc avatarTedScoutio.github.sdmcc/tedscout-mcpSearch EU public tenders across TED and 8 national portals. Monitor, match, and analyse procurement.0stars
5shagarwal avatarDatabazaarshagarwal/databazaar-mcpSearch and preview datasets publicly. Account-required full data via MCP.0stars
6sigaihealth avatarCancer Support Hubsigaihealth/cancersupportSearch 585+ free cancer support resources across Washington State in 7 languages0stars