Apple Contacts — MCP-сервер для Claude Code: поиск контактов на macOS
Даёт ИИ-клиенту доступ к «Контактам» на macOS: находит нужного человека и превращает его в готового получателя сообщения.
claude mcp add --env APPLE_CONTACTS_MCP_SAFETY_MODE=<APPLE_CONTACTS_MCP_SAFETY_MODE> --transport stdio applecontacts-mcp -- uvx apple-contacts-mcpЧто делает Apple Contacts
Сервер поднимается локально на Mac и отдаёт клиенту инструменты для чтения и поиска записей в «Контактах». Отдельная функция — превратить найденный контакт в получателя, которого можно сразу подставить в письмо или сообщение. Полезно, когда агенту нужно отправить что-то человеку, а точного адреса под рукой нет.
Нужен Python 3.11+ и macOS. Запуск идёт через uvx apple-contacts-mcp, поэтому сначала поставьте uv — без него команда не сработает. Режим безопасности задаётся переменной APPLE_CONTACTS_MCP_SAFETY_MODE; если значение пустое или некорректное, сервер выберет safe_readonly. Доступ к самим «Контактам» вы подтверждаете в системном запросе macOS или в «Системных настройках» — за вас это не сделает никто.
Транспорт по умолчанию — stdio. Для Streamable HTTP нужно задать APPLE_<DOMAIN>_MCP_TRANSPORT=streamable-http и переменные хоста с портом, при этом биндинг разрешён только на 127.0.0.1, ::1 или localhost: удалённой аутентификации у серверов нет, сетевые и wildcard-адреса отклоняются. Через туннель или публичный прокси их выставлять нельзя. Данные, которые сервер вернул, клиент может отправить своему провайдеру модели, а приложения Apple синхронизируются через iCloud — локальный запуск не значит, что данные остаются на месте.
Какие задачи решает
- найти контакт по имени, когда точного адреса нет
- подставить получателя в письмо или сообщение
- проверить, что нужный человек есть в «Контактах»
- отдать агенту доступ только к контактам, не открывая почту и календарь
Примеры запросов агенту
- Найди в «Контактах» Марию Соколову и покажи её адрес почты
- Подбери получателя для письма про договор и проверь адрес через контакты
- Поищи контакт по фамилии Reed и скажи, какой у него номер телефона
Как установить Apple Contacts
Командой платформы
claude mcp add --env APPLE_CONTACTS_MCP_SAFETY_MODE=<APPLE_CONTACTS_MCP_SAFETY_MODE> --transport stdio applecontacts-mcp -- uvx apple-contacts-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-contacts-mcp <команда>
Командой платформы
codex mcp add applecontacts-mcp --env APPLE_CONTACTS_MCP_SAFETY_MODE=<APPLE_CONTACTS_MCP_SAFETY_MODE> -- uvx apple-contacts-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-contacts-mcp <команда>
Файл настроек
{
"mcpServers": {
"applecontacts-mcp": {
"command": "uvx",
"args": [
"apple-contacts-mcp"
],
"env": {
"APPLE_CONTACTS_MCP_SAFETY_MODE": "<APPLE_CONTACTS_MCP_SAFETY_MODE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-contacts-mcp <команда>
Файл настроек
{
"servers": {
"applecontacts-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"apple-contacts-mcp"
],
"env": {
"APPLE_CONTACTS_MCP_SAFETY_MODE": "<APPLE_CONTACTS_MCP_SAFETY_MODE>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-contacts-mcp <команда>
Командой платформы
gemini mcp add -e APPLE_CONTACTS_MCP_SAFETY_MODE=<APPLE_CONTACTS_MCP_SAFETY_MODE> applecontacts-mcp uvx apple-contacts-mcpВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from apple-contacts-mcp <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Apple Contacts
Как установить Apple Contacts в Claude Code?
Выполните claude mcp add apple-contacts-mcp -- uvx apple-contacts-mcp. После установки перезапустите клиент.
Что делает Apple Contacts?
Ищет и просматривает записи в «Контактах» на macOS и умеет превратить найденный контакт в получателя, готового для отправки сообщения.
Что нужно для работы сервера?
macOS и Python 3.11+, а также установленный uv — запуск идёт через uvx. Доступ к «Контактам» придётся подтвердить в системном запросе macOS.
