mail_resolve_addresses

MCP tool from Mac MCP by DaniAkash

Bulk-resolve 1 to 100 bare email addresses against the local AddressBook. Returns a contact summary per email on exact match, null otherwise. Substring matches are filtered out.

How to use it

Project documentation lists mail_resolve_addresses for the Mac MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.

Install Mac MCP

$bunx -y github:DaniAkash/mac-mcp
FULL MAC MCP LISTING

Other tools in Mac MCP (19)

calendar_get_event

Full event by UUID with description and last-modified.

calendar_list_calendars

List every calendar with id, title, type (Local, CalDAV, Birthdays, Subscribed, etc.) and color.

calendar_list_events

Events sorted by start time. Optional calendar id and YYYY-MM-DD date bounds.

calendar_search

Substring search across title, description, and location with optional date bounds.

contacts_get

Fetch a full record by Apple's ZUNIQUEID (<GUID>:ABPerson). Includes every email, phone, postal address, URL, and the note text.

contacts_list

Page through contacts merged across every AddressBook source; output is sorted by display name.

contacts_search

Substring search by name (first/last/nick/organisation), email (normalised), phone (digits or last-four), or all.

mail_get_email

Fetch a full email by Mail.app integer id with body, recipients, headers. Pass includeHtml: true to also return the raw text/html MIME part on the response (capped at 1 MiB).

mail_get_email_attachment

Fetch one attachment's bytes as base64 by 0-based index. Default cap 5 MiB, hard cap 10 MiB; larger attachments return an error envelope describing the actual size.

mail_get_email_attachments

List attachment metadata for an email: index, filename, content type, size, disposition, optional content-id.

mail_get_email_links

Extract every URL from an email body and the List-Unsubscribe / List-Help / List-Archive headers. Returns (url, kind, text?, inHeader?) records. Optional kinds filter, dedupe, and limit.

mail_get_emails

Recency-sorted email list. Optional account, mailbox, category (primary/transactions/updates/promotions), filter (all/unread/flagged/today/last7days), before/after (YYYY-MM-DD), and groupby to bucket by unread state, category, or account.

mail_list_accounts

List all Mail accounts with display names + UUIDs.

mail_list_mailboxes

List mailboxes per account with current unread counts.

mail_search

FTS5 BM25 search across subject/sender/body with scope, account, mailbox, category, and date filters.

reminders_get_reminder

Full reminder by identifier with notes, start/due/completion dates.

reminders_list_lists

Every list across every account; type distinguishes regular lists from Smart Lists.

reminders_list_reminders

Reminders sorted by due date. Optional list id and open/completed/all status (default open).

reminders_search

Substring search across title and notes.