Apple Contacts · mgcrea — MCP-сервер для Claude Code: поиск и установка
MCP-сервер ищет записи в адресной книге macOS и связывает номера телефонов и адреса почты с именами. Запись контактов выключена, пока не задана переменная разрешения.
claude mcp add --env APPLE_CONTACTS_ALLOW_WRITES=<APPLE_CONTACTS_ALLOW_WRITES> --transport stdio contacts -- npx -y @mgcrea/mcp-apple-contactsЧто делает Apple Contacts
Apple Contacts даёт агенту инструменты для поиска и чтения контактов: можно разрешить номер или адрес почты в имя, искать записи, просматривать список и получать отдельный контакт. При неоднозначном совпадении сервер возвращает соответствующий статус, а не выбирает контакт наугад.
Создание и изменение контактов доступны только при APPLE_CONTACTS_ALLOW_WRITES=1; без этого инструменты записи не показываются агенту. Для чтения macOS запрашивает разрешение на доступ к контактам. Это отдельное системное разрешение, его нужно подтвердить в появившемся диалоге.
Сервер читает адресную книгу на Mac и поддерживает несколько хранилищ контактов. При включённой записи каждое изменение сохраняется, а затем перечитывается: это важно, потому что изменение может отображаться в текущем скрипте, но не попасть в хранилище.
Какие задачи решает
- Найти имя по номеру телефона
- Определить владельца адреса почты
- Найти контакт по запросу
- Получить данные выбранной записи
- Создать или изменить контакт с включённой записью
Примеры запросов агенту
- Найди в контактах человека с адресом
[email protected]. - Разреши эти номера телефонов в имена и покажи неоднозначные совпадения.
- Создай контакт с именем «Алексей» и номером
+1....
Как установить Apple Contacts
Командой платформы
claude mcp add --env APPLE_CONTACTS_ALLOW_WRITES=<APPLE_CONTACTS_ALLOW_WRITES> --transport stdio contacts -- npx -y @mgcrea/mcp-apple-contactsВместо <…> подставьте свои значения
Командой платформы
codex mcp add contacts --env APPLE_CONTACTS_ALLOW_WRITES=<APPLE_CONTACTS_ALLOW_WRITES> -- npx -y @mgcrea/mcp-apple-contactsВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"contacts": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-contacts"
],
"env": {
"APPLE_CONTACTS_ALLOW_WRITES": "<APPLE_CONTACTS_ALLOW_WRITES>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"contacts": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-contacts"
],
"env": {
"APPLE_CONTACTS_ALLOW_WRITES": "<APPLE_CONTACTS_ALLOW_WRITES>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e APPLE_CONTACTS_ALLOW_WRITES=<APPLE_CONTACTS_ALLOW_WRITES> contacts npx -y @mgcrea/mcp-apple-contactsВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Apple Contacts
Как установить Apple Contacts в Claude Code?
Выполните claude mcp add mcp-apple-contacts -- npx -y @mgcrea/mcp-apple-contacts. Для этого варианта команда добавляет сервер с чтением контактов.
Что делает Apple Contacts?
Сервер позволяет искать и читать контакты macOS, в том числе сопоставлять телефонные номера и адреса почты с именами. Создание и изменение записей доступны только при включённом разрешении на запись.
Как разрешить Apple Contacts изменять записи?
Задайте APPLE_CONTACTS_ALLOW_WRITES=1 в настройке сервера. Тогда инструменты создания и изменения контактов станут доступны агенту.
Похожие MCP-серверы
Все MCP-серверы по теме «Настройка агента: память, контекст, субагенты» →Сначала — Apple Contacts от других авторов.
