Apple Messages · mgcrea — MCP-сервер для Claude Code: чтение и установка
MCP-сервер ищет и читает чаты Apple Messages на macOS, включая iMessage, SMS и RCS. Отправка сообщений выключена по умолчанию.
claude mcp add --env APPLE_MESSAGES_ALLOW_WRITES=<APPLE_MESSAGES_ALLOW_WRITES> --env APPLE_MESSAGES_ALLOW_CODES=<APPLE_MESSAGES_ALLOW_CODES> --env APPLE_MESSAGES_ALLOW_FILE_SEND=<APPLE_MESSAGES_ALLOW_FILE_SEND> --transport stdio messages -- npx -y @mgcrea/mcp-apple-messagesЧто делает Apple Messages
Apple Messages подключает к агенту хранилище сообщений на Mac. Доступны диагностика, списки чатов и сообщений, поиск, получение отдельного сообщения и подсчёт сообщений с группировкой по дате, чату, контакту или направлению. Текст сообщений декодируется из attributedBody, а имена собеседников разрешаются через @mgcrea/mcp-apple-contacts.
Отправка выполняется через send_message и требует отдельного разрешения APPLE_MESSAGES_ALLOW_WRITES. По умолчанию запись выключена; отправка файлов через filePath дополнительно зависит от APPLE_MESSAGES_ALLOW_FILE_SEND, а поиск кодов включается через APPLE_MESSAGES_ALLOW_CODES. Без Full Disk Access сервер не работает, поэтому это нужно настроить до запуска.
Какие задачи решает
- найти сообщения по тексту
- прочитать историю выбранного чата
- посчитать сообщения по дням или направлениям
- сопоставить номера с именами контактов
- отправить сообщение в существующий чат
Примеры запросов агенту
- Найди в Apple Messages сообщения о заказе за последний месяц.
- Покажи последние сообщения из чата с этим контактом и посчитай их по направлениям.
- Отправь в выбранный чат сообщение с текстом из
release-notes.md.
Как установить Apple Messages
Командой платформы
claude mcp add --env APPLE_MESSAGES_ALLOW_WRITES=<APPLE_MESSAGES_ALLOW_WRITES> --env APPLE_MESSAGES_ALLOW_CODES=<APPLE_MESSAGES_ALLOW_CODES> --env APPLE_MESSAGES_ALLOW_FILE_SEND=<APPLE_MESSAGES_ALLOW_FILE_SEND> --transport stdio messages -- npx -y @mgcrea/mcp-apple-messagesВместо <…> подставьте свои значения
Командой платформы
codex mcp add messages --env APPLE_MESSAGES_ALLOW_WRITES=<APPLE_MESSAGES_ALLOW_WRITES> --env APPLE_MESSAGES_ALLOW_CODES=<APPLE_MESSAGES_ALLOW_CODES> --env APPLE_MESSAGES_ALLOW_FILE_SEND=<APPLE_MESSAGES_ALLOW_FILE_SEND> -- npx -y @mgcrea/mcp-apple-messagesВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"messages": {
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-messages"
],
"env": {
"APPLE_MESSAGES_ALLOW_WRITES": "<APPLE_MESSAGES_ALLOW_WRITES>",
"APPLE_MESSAGES_ALLOW_CODES": "<APPLE_MESSAGES_ALLOW_CODES>",
"APPLE_MESSAGES_ALLOW_FILE_SEND": "<APPLE_MESSAGES_ALLOW_FILE_SEND>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"messages": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@mgcrea/mcp-apple-messages"
],
"env": {
"APPLE_MESSAGES_ALLOW_WRITES": "<APPLE_MESSAGES_ALLOW_WRITES>",
"APPLE_MESSAGES_ALLOW_CODES": "<APPLE_MESSAGES_ALLOW_CODES>",
"APPLE_MESSAGES_ALLOW_FILE_SEND": "<APPLE_MESSAGES_ALLOW_FILE_SEND>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e APPLE_MESSAGES_ALLOW_WRITES=<APPLE_MESSAGES_ALLOW_WRITES> -e APPLE_MESSAGES_ALLOW_CODES=<APPLE_MESSAGES_ALLOW_CODES> -e APPLE_MESSAGES_ALLOW_FILE_SEND=<APPLE_MESSAGES_ALLOW_FILE_SEND> messages npx -y @mgcrea/mcp-apple-messagesВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Apple Messages
Как установить Apple Messages в Claude Code?
Выполните claude mcp add mcp-apple-messages -- npx -y @mgcrea/mcp-apple-messages. После установки выдайте серверу Full Disk Access в macOS.
Что делает Apple Messages?
Сервер читает чаты, сообщения и их текст, ищет совпадения, возвращает сведения о контактах и считает сообщения с группировкой. Отправка доступна отдельно и выключена по умолчанию.
Что нужно Apple Messages для работы?
Сервер работает с хранилищем Apple Messages на macOS и требует Full Disk Access. Для разрешения имён используется @mgcrea/mcp-apple-contacts; без доступа к контактам номера возвращаются как есть.
Похожие MCP-серверы
Каталог MCP-серверов →Сначала — Apple Messages от других авторов.
