Apple Contacts

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/mgcrea-mcp-apple-contacts

About

Use cases: crm

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools

5 read · 2 write · 0 delete

Secrets

None asked for

Install scripts

None found

Runs as

Node.js package

Tools (7)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

• apple_contacts_create_contact

  Create a new contact in the address book. This is a real card in the user's real Contacts, and on an iCloud account it syncs to their other devices within seconds. Give at least one of firstName, lastName or organization. Contacts keeps edits in an unsaved buffer and its save command commits EVERYTHING pending, so this also saves any edit someone has half-typed in the Contacts window. That is how the app's scripting works, not a choice this server makes. The result is re-read after saving, so what comes back is what Contacts stored rather than what was asked for.

• apple_contacts_diagnosticsread-only

  Report which Contacts stores were opened, how many contacts each holds, and what this server cannot do. Start here when a lookup returns nothing.

• apple_contacts_get_contactread-only

  One contact in full: name, organisation, job title, every phone number and every email address, each with its label.

• apple_contacts_list_contactsread-only

  List contacts across every account. This is the whole address book, so prefer apple_contacts_search_contacts when you are looking for someone specific.

• apple_contacts_resolve_handlesread-only

  Turn phone numbers or email addresses into contact names. Give it the raw identifiers from somewhere else — Messages handles, a caller ID, an email header — and it returns one result per handle. Read `status` on every result rather than assuming a name came back: - "resolved" — exactly one contact. `name` is set. - "unknown" — nobody in the address book has this number. COMMON AND NOT AN ERROR: measured on a real store, about one in six of even the busiest correspondents does not resolve. Show the raw handle. - "ambiguous" — more than one contact has it, so no name is returned. Do not guess; …

• apple_contacts_search_contactsread-only

  Search the address book by name, nickname or organisation. Returns a ref for each match, plus which account it came from — the same person can legitimately appear twice if they are in two accounts. Use apple_contacts_get_contact for phone numbers and email addresses.

• apple_contacts_update_contact

  Change an existing contact, or add a phone number or email address to one. Omitting a field leaves it alone; passing null clears it. Phones and emails are ADDED, never replaced — Contacts models them as separate objects, and there is no way to remove one through its scripting dictionary. Contacts keeps edits in an unsaved buffer and its save command commits EVERYTHING pending, so this also saves any edit someone has half-typed in the Contacts window. That is how the app's scripting works, not a choice this server makes. The result is re-read after saving, so what comes back is what Contacts st…

Signals

Stars

5

Forks

0

Open issues

2

Weekly downloads

272

Last commit (this folder)

Oct 22, 2026 (9 days ago)

Last release

Oct 25, 2026 (5 days ago)

Last package publish

Oct 22, 2026 (8 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name

io.github.mgcrea/mcp-apple-contacts

Version

1.31.0

Auth

No auth

Packages

npm @mgcrea/mcp-apple-contacts

License

MIT

Repository

github.com/mgcrea/cupertino

Website

cupertino.mgcrea.io

First seen

Oct 24, 2026

Last checked

Oct 26, 2026

Source

Official MCP Registrygithub-graphql