mcpbeat Sign in

Apple Contacts MCP Server

local only

Apple Contacts runs on your own machine — the client starts it, so there is no endpoint to ping. 1 583 installs a week from pypi. Last commit 16 Oct 2026.

Inspect and search Apple Contacts on macOS, and resolve a contact into a message-ready recipient.

Installs per day peak 443 · avg 94 · +428% w/w
a month agotoday
1 583
Installs / week
pypi · apple-contacts-mcp
28
Stars
4 open issues
16 Oct 2026
Last commit
from GitHub
MIT
License
Python

What the code does

We read the source, 14 h ago · rules ccca72095570

Capabilities

What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.

File ships in the package but is absent from the source [пакет] src/apple_contacts_mcp/__init__.py:1, [пакет] src/apple_contacts_mcp/__main__.py:1, [пакет] src/apple_contacts_mcp/config.py:1 и ещё 4
этот файл ставится пользователю, но в репозитории его нет

Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.

This code can reach further than it looks

We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.

Three servers free · no card

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

run in your terminal
claude mcp add apple-contacts-mcp -- uvx apple-contacts-mcp
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "apple-contacts-mcp": {
      "args": [
        "apple-contacts-mcp"
      ],
      "command": "uvx"
    }
  }
}
~/.codex/config.toml
[mcp_servers.apple-contacts-mcp]
command = "uvx"
args = ["apple-contacts-mcp"]
.cursor/mcp.json
{
  "mcpServers": {
    "apple-contacts-mcp": {
      "args": [
        "apple-contacts-mcp"
      ],
      "command": "uvx"
    }
  }
}
.vscode/mcp.json
{
  "mcpServers": {
    "apple-contacts-mcp": {
      "args": [
        "apple-contacts-mcp"
      ],
      "command": "uvx"
    }
  }
}

This one needs environment variables set before it will start: APPLE_CONTACTS_MCP_SAFETY_MODE (Safety mode for Contacts operations: safe_readonly, safe_manage, or full_access.). The author declared them in the registry entry; get the values from the project itself.

Alternatives to Apple Contacts

same job, measured the same way
Apple Notes
by jonathanrreed

Inspect, search, create, edit, move, and organize notes in Apple Notes on macOS.

1 545 installs/wk local only
Apple Mail
by jonathanrreed

Read, search, compose, and send emails via Apple Mail on macOS.

1 596 installs/wk local only
Apple Shortcuts
by jonathanrreed

List, inspect, and run Apple Shortcuts on macOS.

1 561 installs/wk local only
Apple Contacts
by mgcrea

Search and read Apple Contacts — resolves numbers and emails to names, writes off by default

128 installs/wk local only
Waspy
by waspytech

Search contacts, read chats, and send confirmed messages for one Waspy account.

answering
Imessage Max
by cyberpapiii

AI-optimized MCP server for iMessage on macOS. Read, search, and send messages.

254 installs/wk local only
iMessage History
by anipotts

Search and read your Apple Messages history from any MCP client. Read-only, local.

221 installs/wk local only
Apple Messages
by jonathanrreed

Read Messages history on macOS and send or reply through Messages.app.

1 546 installs/wk local only

Apple Contacts — questions

Answers built from our own checks of this server.

Why is there no uptime for Apple Contacts?
Apple Contacts runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the pypi package apple-contacts-mcp was installed 1 583 times last week.
How do I connect Apple Contacts?
Copy the ready config from this page — we generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each with the file path that client actually reads. It runs locally, so the command pulls apple-contacts-mcp straight from pypi; nothing to host, nothing to sign up for.
How many people use Apple Contacts?
The pypi package apple-contacts-mcp was installed 1 583 times in the last week. Week over week that is +428%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.
Is Apple Contacts open source?
Yes — it is published under the MIT licence, written in Python, 28 stars on GitHub and 4 open issues. The source link is on this page, so you can read exactly what it does with your data before you connect it.