Skip to content
MCP server

Apple Contacts

Search and read Apple Contacts on a Mac, with write tools hidden until enabled

Runs locallyStatus and history
Pricing
Free trial
Platforms
macOS, CLI
Runs
Locally
Version
1.40.0
Listing updated
3 days ago

About Apple Contacts

Apple Contacts is an MCP server for productivity. It runs locally on your machine and is started by your AI client.

Contacts is the part of Cupertino that resolves a phone number or email to a name, which the Mail, Calendar and Messages servers use to answer who said what. It reads the local contact stores through one Full Disk Access grant held by a signed menu-bar app, falling back to Apple Events, and covers multiple accounts.

Five read tools handle diagnostics, handle resolution, search, listing and fetching one contact. The write tools, create_contact and update_contact, are not just refused when off: with APPLE_CONTACTS_ALLOW_WRITES unset they are never registered, so the model cannot see them. Phone matching uses a suffix key (nine digits by default, configurable from 6 to 15).

It needs macOS 26 or later, is unofficial and not affiliated with Apple, and the servers are MIT licensed. The Cupertino app has a 30-minute trial with no account and a 30-day refund.

Install

Run in a terminal

claude mcp add mcp-apple-contacts -- npx -y @mgcrea/mcp-apple-contacts

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-apple-contacts": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-contacts"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-apple-contacts": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-contacts"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-apple-contacts": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-contacts"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-apple-contacts": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-contacts"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-apple-contacts": {
      "command": "npx",
      "args": [
        "-y",
        "@mgcrea/mcp-apple-contacts"
      ]
    }
  }
}

Configuration

  • APPLE_CONTACTS_ALLOW_WRITESRegister the mutating tools. Off by default, and the gate decides whether the write tools exist at all rather than merely refusing — an agent with writes off cannot see them.

Tools this server provides (7)

Taken from the project documentation; the running server may differ.

diagnostics
No description
resolve_handles
No description
search_contacts
No description
list_contacts
No description
get_contact
No description
create_contact
No description
update_contact
No description

What it does

Handle resolution
Turns phone numbers and emails into contact names.
Read tools
Search, list and fetch contacts.
Hidden writes
Create and update tools only exist when enabled.
Multi-store
Queries every contact store on the Mac.
No phone-home
Described as reading locally with every call visible.

Good for

  • Identify who a number belongs to in an agent task
  • Look up a colleague's details
  • Let an agent add a contact after you enable writes
  • Combine contacts with mail and calendar lookups

Pricing

Free trial

Servers MIT; Cupertino app has a 30-minute trial and 30-day refund; price not published

Prices change. Check cupertino.mgcrea.io before you buy.

Apple Contacts FAQ

Can the agent edit my contacts by default?

No. Write tools are not registered unless APPLE_CONTACTS_ALLOW_WRITES is set.

What macOS is needed?

macOS 26 or later.

Is it affiliated with Apple?

No, it is unofficial.

Is Apple Contacts free?

Apple Contacts is a paid product with a free trial.

How do I add Apple Contacts to Claude Code?

Run this command in your terminal: claude mcp add mcp-apple-contacts -- npx -y @mgcrea/mcp-apple-contacts

What are the best alternatives to Apple Contacts?

The closest alternatives to Apple Contacts are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

Alternatives to Apple Contacts

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media