messages — MCP-сервер для Claude Code: поиск по iMessage
Ищет и просматривает переписку в Apple Messages с клавиатуры или через ИИ-агента. Пригодится, когда нужно быстро найти, о чём договорились в чате.
claude mcp add messages -- npx -y @cardmagic/messagesЧто делает messages
Сервер читает базу Apple Messages и строит по ней два поисковых индекса: SQLite FTS5 для полнотекстового поиска и MiniSearch для нечёткого, который прощает опечатки. Индекс пересобирается сам, когда появляются новые сообщения. Контакты подтягиваются из адресной книги, поэтому вместо номеров видны имена.
Запрос можно сузить по отправителю и дате, а вокруг каждого совпадения показать соседние сообщения. Помимо поиска есть просмотр недавних сообщений, списка контактов по активности и целых тредов. Всё это доступно из командной строки, как инструменты MCP-сервера или через плагин Claude с готовыми слэш-командами вроде /messages:search.
Работает только на macOS: база лежит в ~/Library/Messages/chat.db. Нужен Node.js 22 или новее, а терминалу надо выдать Full Disk Access, иначе чтение базы не пройдёт. Для ускорения поиска индекс хранится в ~/.messages/.
Какие задачи решает
- найти, о чём договорились в переписке, не листая её вручную
- показать недавние сообщения и понять, кто писал последним
- собрать тред с конкретным человеком за нужный период
- найти сообщение с опечаткой в запросе
- посмотреть контакты, с которыми переписка идёт активнее всего
Примеры запросов агенту
- Найди в сообщениях, что мама писала про ужин
- Покажи недавние сообщения от John за декабрь
- Кто мне писал за последние дни?
Как установить messages
Командой платформы
claude mcp add messages -- npx -y @cardmagic/messagesКомандой платформы
codex mcp add messages -- npx -y @cardmagic/messagesФайл настроек
{
"mcpServers": {
"messages": {
"command": "npx",
"args": [
"-y",
"@cardmagic/messages"
]
}
}
}Файл настроек
{
"servers": {
"messages": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@cardmagic/messages"
]
}
}
}Командой платформы
gemini mcp add messages npx -y @cardmagic/messagesПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о messages
Как установить messages в Claude Code?
Добавьте сервер командой claude mcp add messages -- npx -y @cardmagic/messages. Есть и плагин с авто-скиллом и слэш-командами: сначала claude plugin marketplace add cardmagic/ai-marketplace, потом claude plugin install messages@cardmagic.
Что делает messages?
Ищет по вашей переписке в Apple Messages с допуском на опечатки, показывает недавние сообщения, контакты и треды. Работает из терминала, как MCP-сервер или как плагин Claude.
Что нужно для работы messages?
macOS, Node.js 22 или новее и разрешение Full Disk Access для терминала: без него база ~/Library/Messages/chat.db не читается.
