search_emails

MCP tool from Apple Mail MCP by patrickfreyer

Unified search — subject, sender, body text, dates, attachments, flag status/color, cross-account

How to use it

search_emails is exposed by the Apple Mail MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the search_emails tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

Install Apple Mail MCP

$claude mcp add apple-mail -- uvx mcp-apple-mail

FULL APPLE MAIL MCP LISTING

Other tools in Apple Mail MCP (23)

Send new emails (plain text or HTML body)

Create new mailboxes (supports nested paths)

create_rich_email_draft

Build a rich HTML .eml draft, open it in Mail, and optionally save it to Drafts

Export single emails or mailboxes to TXT/HTML

Forward with optional message, CC/BCC

get_awaiting_reply

Find sent emails that haven't received a reply

get_email_thread

Conversation thread view

get_inbox_overview

Dashboard with unread counts, folders, and recent emails

get_mailbox_unread_counts

Unread counts per mailbox or per-account summary

get_needs_response

Identify emails that likely need your response

Email analytics (volume, top senders, read ratios)

get_top_senders

Analyse most frequent senders by count or domain

inbox_dashboard

Interactive UI dashboard (requires mcp-ui-server)

List all configured Mail accounts

list_email_attachments

List attachments with names and sizes

list_inbox_emails

List emails with account/read-status filtering and optional content preview

Folder hierarchy with message counts

Create, list, send, and delete drafts

Soft delete, permanent delete, empty trash (with dry-run)

Move/archive emails with filters (subject, sender, date, read status, dry-run)

Reply or reply-all with optional HTML body

save_email_attachment

Save attachments to disk

update_email_status

Mark read/unread, flag/unflag (optional flag color) — by filters or message IDs