imessage-mcp

MCP-сервер с доступом только для чтения, который предоставляет ваши данные iMessage для Claude Code и Claude Desktop с автоматическим определением имен контактов.

Настройка

1. Установка

cd ~/workspace/imessage-mcp
python3.12 -m venv .venv
source .venv/bin/activate
pip install -e .

2. Предоставление полного доступа к диску

Серверу необходимо считывать ~/Library/Messages/chat.db и базу данных контактов. Предоставьте Полный доступ к диску приложению, которое запускает сервер:

1. Откройте Системные настройки → Конфиденциальность и безопасность → Полный доступ к диску

2. Для Claude Code: добавьте ваше приложение терминала (например, Terminal, iTerm2, Ghostty)

3. Для Claude Desktop: добавьте приложение Claude

3. Настройка Claude Code

Добавьте в ~/.claude/settings.json:

{
  "mcpServers": {
    "imessage": {
      "command": "/Users/jaredmoskowitz/workspace/imessage-mcp/.venv/bin/python",
      "args": ["-m", "imessage_mcp"]
    }
  }
}

4. Настройка Claude Desktop

Добавьте в ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "imessage": {
      "command": "/Users/jaredmoskowitz/workspace/imessage-mcp/.venv/bin/python",
      "args": ["-m", "imessage_mcp"]
    }
  }
}

Related MCP server: imessage-rich-search

Инструменты

list_chats

Список ваших чатов iMessage, отсортированный по недавней активности.

• limit (необязательно, по умолчанию 50): максимальное количество чатов для вывода

get_messages

Получение сообщений из определенного чата.

• chat_id (обязательно): идентификатор чата из list_chats

• limit (необязательно, по умолчанию 50): максимальное количество сообщений

• since (необязательно): строка даты в формате ISO — только сообщения после этой даты

search_messages

Поиск сообщений по всем чатам по ключевому слову.

• query (обязательно): текст для поиска

• limit (необязательно, по умолчанию 50): максимальное количество результатов

Пример использования

"List my group chats" "Get the last 20 messages from my Business Ideas chat" "Search my messages for 'startup idea'"