contacts_get

MCP tool from Mac MCP by DaniAkash

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

How to use it

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

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_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_resolve_addresses

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.

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.