Mac Messages MCP
MCP-сервер для macOS: агент читает, ищет и отправляет сообщения в приложении Сообщения на вашем Mac
- 339 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Читает вашу личную переписку и контакты из баз macOS
- Инструменты отправки и отложенной отправки пишут от вашего имени реальным людям
- Работа требует системных разрешений macOS для запускающего приложения
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mac-messages-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Читает вашу личную переписку и контакты из баз macOS
- Инструменты отправки и отложенной отправки пишут от вашего имени реальным людям
- Работа требует системных разрешений macOS для запускающего приложения
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Mac Messages MCP работает локально на вашем Mac и дает MCP-клиенту доступ к приложению Сообщения. Базы Сообщений и Контактов он открывает только на чтение и возвращает лишь то, что запросил клиент. Автоматизацию Messages.app сервер включает, только когда клиент явно вызывает инструмент отправки. Читать можно свежие сообщения по контакту, групповому чату или интервалу дат, с постраничным выводом. Поиск по тексту нечеткий, за выбранный период или за все время. Отдельные инструменты ищут контакты по приблизительному имени, находят вложения и ищут текст внутри PDF. Отправка идет через iMessage, а при неудаче через SMS или RCS. К сообщению можно приложить файл и включить подтверждение человеком через MCP. Сообщение можно поставить в очередь на отправку позже. Текст из сообщений и контактов возвращается модели в рамке недоверенных данных. В комплекте три готовых промпта и навык для агента.
Для кого. Для пользователей Mac, которые хотят разбирать входящие, искать по переписке и отвечать через Claude, Codex или Cursor.
Подходит, если
- Нужно просмотреть непрочитанные сообщения и составить краткую сводку по людям
- Требуется найти в переписке договоренность о дате по приблизительной формулировке
- Агент готовит ответ, а вы подтверждаете отправку в самом клиенте
- Нужно получить вложение из беседы, например приглашение в виде изображения или PDF
Не подходит, если
- Вы не на macOS: сервер работает только на Mac
- Нужны реакции, правка или удаление сообщений: автоматизация Messages.app этого не дает
- Переписку нельзя показывать модели облачного провайдера: найденный текст уходит в контекст агента
Пример запроса к агенту
Покажи непрочитанные сообщения за сегодня и составь для каждого человека одну строку, что он проситMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
MAC_MESSAGES_REGION- Код региона по ISO 3166-1 для разбора национальных номеров, например GB
Ограничения
Только macOS. Для чтения приложению, которое запускает клиент, нужен полный доступ к диску. Отправка работает, если Mac вошел в Сообщения, а Контакты и Сообщения доступны запускающему приложению. Нужен Python 3.10 или новее, uvx поставит его сам. Нельзя отправлять реакции, эффекты и тему, создавать группы, править и удалять сообщения. Отложенные сообщения не сохраняются на диск: при отключении клиента они пропадают.
Как отключить. Удалите запись mac-messages из конфигурации клиента, для Claude Code выполните claude mcp remove mac-messages. Затем в настройках macOS уберите полный доступ к диску у приложения, которому вы его выдавали.
Частые вопросы
Как подключить Mac Messages MCP к Claude Code?
Выполните claude mcp add --transport stdio --scope user mac-messages -- uvx mac-messages-mcp. Проверить подключение можно командой claude mcp get mac-messages или командой /mcp внутри Claude Code.
Какие еще разрешения macOS нужны серверу?
Для отправки Mac должен быть вошедшим в Сообщения, а запускающее приложение получает разрешение управлять Messages.app. Доступ к Контактам macOS спросит отдельно при первом поиске контакта.
В каком формате указывать получателя?
Надежнее всего номер в формате E.164, например +14155551234. Национальный формат расширяется по региону вашего Mac, регион можно задать переменной MAC_MESSAGES_REGION. Принимаются также адрес почты, имя контакта и идентификатор группового чата.
Отправит ли агент сообщение без моего ведома?
Отправка идет только вызовом инструмента tool_send_message. Для него можно включить подтверждение человеком через MCP, а промпты сервера ничего не отправляют.
Как сервер защищается от текста внутри сообщений?
Текст из сообщений и контактов возвращается модели в рамке недоверенных данных, чтобы чужое сообщение не воспринималось как команда.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер к личному аккаунту WhatsApp: поиск и чтение переписки, контакты, отправка сообщений и файлов через агента
iMCP
imcp
Приложение для macOS, которое открывает ИИ календарь, контакты, напоминания, сообщения и другие данные Mac через MCP. Не связано с Apple
Пачка MCP
mcp-pachca
MCP-сервер для корпоративного мессенджера Пачка: чаты, поиск по сообщениям, пользователи и отправка сообщений
MCP-сервер для Slack: история каналов, треды, личные сообщения, поиск и непрочитанное, запись выключена по умолчанию
MCP почта на 52 инструмента: агент читает, ищет, отправляет и сортирует письма в нескольких ящиках по IMAP и SMTP, планирует отправку
MCP-сервер почты по IMAP и SMTP: агент ищет, читает, сортирует и отправляет письма из нескольких ящиков
Коротко о README
Документация начинается со схемы потока данных и ведет по настройке пяти клиентов, от Claude Desktop до VS Code. У каждого инструмента в таблице отмечены побочные эффекты, отдельно описана сборка расширения для Claude Desktop.