Apple Contacts
Search and read Apple Contacts on a Mac, with write tools hidden until enabled
- 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-contactsAdd to claude_desktop_config.json
{
"mcpServers": {
"mcp-apple-contacts": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-contacts"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-apple-contacts": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-contacts"
]
}
}
}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

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity

Concord MCP
MCP serverLocal-first MCP server for messaging and shared work-state between coding agents
Runs locally- Freemium
- 1.3K GitHub stars
- Developer tools

note1
MCP serverMCP server giving AI assistants search and summaries across your note1 meetings
- 4 tools
- Remote
- Free trial
- 1 GitHub star
- Productivity

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media