iMessage History — MCP-сервер для Claude Code: установка
MCP-сервер ищет и читает историю сообщений Apple на macOS. Он пригодится, когда агенту нужен контекст переписки без отправки данных в облако.
claude mcp add --env IMESSAGE_PRIVACY=<IMESSAGE_PRIVACY> --env IMESSAGE_CONTACTS=<IMESSAGE_CONTACTS> --env IMESSAGE_DB=<IMESSAGE_DB> --env IMESSAGE_CACHE=<IMESSAGE_CACHE> --env IMESSAGE_UPDATE_CHECK=<IMESSAGE_UPDATE_CHECK> --transport stdio anipottsbuilds-imessage-history -- npx -y imessage-mcpЧто делает iMessage History
iMessage History подключает историю Apple Messages к MCP-клиенту. Сервер ищет сообщения по словам, точному тексту или фразе, читает переписки с реакциями, ответами и вложениями, показывает отправленные фотографии и следит за новыми сообщениями. Режим только для чтения: отправлять ответы он не умеет.
Сервер работает локально на Mac и не требует аккаунта или сборки. Нужны macOS 14 или новее и Node.js 24.16 или новее для установки через npx; для зашифрованного кэша советуется Node 24 LTS. Без Full Disk Access приложение не прочитает историю. После выдачи доступа приложение нужно полностью перезапустить.
Какие задачи решает
- найти сообщение по слову или фразе
- прочитать историю конкретной переписки
- собрать сводку сообщений за неделю
- проверить, кто ждёт ответа
- оценить обычное время ответа контакта
Примеры запросов агенту
- Найди в сообщениях переписку о бронировании ужина и перескажи контекст.
- Покажи, кто ждёт моего ответа, и кратко опиши их вопросы.
- Собери сводку переписок за неделю с объёмом сообщений и ожидающими ответа.
Как установить iMessage History
Командой платформы
claude mcp add --env IMESSAGE_PRIVACY=<IMESSAGE_PRIVACY> --env IMESSAGE_CONTACTS=<IMESSAGE_CONTACTS> --env IMESSAGE_DB=<IMESSAGE_DB> --env IMESSAGE_CACHE=<IMESSAGE_CACHE> --env IMESSAGE_UPDATE_CHECK=<IMESSAGE_UPDATE_CHECK> --transport stdio anipottsbuilds-imessage-history -- npx -y imessage-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add anipottsbuilds-imessage-history --env IMESSAGE_PRIVACY=<IMESSAGE_PRIVACY> --env IMESSAGE_CONTACTS=<IMESSAGE_CONTACTS> --env IMESSAGE_DB=<IMESSAGE_DB> --env IMESSAGE_CACHE=<IMESSAGE_CACHE> --env IMESSAGE_UPDATE_CHECK=<IMESSAGE_UPDATE_CHECK> -- npx -y imessage-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"anipottsbuilds-imessage-history": {
"command": "npx",
"args": [
"-y",
"imessage-mcp"
],
"env": {
"IMESSAGE_PRIVACY": "<IMESSAGE_PRIVACY>",
"IMESSAGE_CONTACTS": "<IMESSAGE_CONTACTS>",
"IMESSAGE_DB": "<IMESSAGE_DB>",
"IMESSAGE_CACHE": "<IMESSAGE_CACHE>",
"IMESSAGE_UPDATE_CHECK": "<IMESSAGE_UPDATE_CHECK>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"anipottsbuilds-imessage-history": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"imessage-mcp"
],
"env": {
"IMESSAGE_PRIVACY": "<IMESSAGE_PRIVACY>",
"IMESSAGE_CONTACTS": "<IMESSAGE_CONTACTS>",
"IMESSAGE_DB": "<IMESSAGE_DB>",
"IMESSAGE_CACHE": "<IMESSAGE_CACHE>",
"IMESSAGE_UPDATE_CHECK": "<IMESSAGE_UPDATE_CHECK>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e IMESSAGE_PRIVACY=<IMESSAGE_PRIVACY> -e IMESSAGE_CONTACTS=<IMESSAGE_CONTACTS> -e IMESSAGE_DB=<IMESSAGE_DB> -e IMESSAGE_CACHE=<IMESSAGE_CACHE> -e IMESSAGE_UPDATE_CHECK=<IMESSAGE_UPDATE_CHECK> anipottsbuilds-imessage-history npx -y imessage-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о iMessage History
Как установить iMessage History в Claude Code?
Выполните claude mcp add imessage-mcp -- npx -y imessage-mcp.
Что делает iMessage History?
Он подключает историю Apple Messages к агенту для поиска и чтения переписок. Сервер работает только на чтение и не отправляет сообщения.
Что нужно для работы iMessage History?
Нужны macOS 14 или новее, Node.js 24.16 или новее для установки через npx и Full Disk Access для приложения, которое запускает сервер.