Для чего этот сервер?

Этот MCP-сервер даёт языковой модели доступ к вашей истории переписки в iMessage на Mac. Он помогает искать сообщения по тексту, контакту или дате, показывать недавние диалоги и находить контакты из адресной книги. Всё только для чтения — отправить сообщение нельзя. Полезно, когда ассистент может ответить на вопрос «что мне писал Иван на прошлой неделе?».

Каталог MCP
wyattjoh/imessage-mcp

wyattjoh/imessage-mcp

от wyattjoh

MCP-сервер для чтения iMessage на macOS через LLM. Поиск сообщений по тексту, контакту или дате, просмотр чатов и контактов адресной книги. Полезен разработчикам, создающим ИИ-ассистентов на Mac.

Github Сайт сервера

README

Инструменты и схема сервера

Версии

Установить сервер

iMessage MCP

A Deno monorepo containing packages for iMessage access on macOS:

@wyattjoh/imessage - Core library for read-only iMessage database access
@wyattjoh/imessage-mcp - Model Context Protocol (MCP) server for LLM integration

Features

Search messages by text content, contact, or date range
Get recent messages
List all chats/conversations
Get all contacts/handles
Retrieve messages from specific chats
Search macOS Contacts by name with iMessage handle ID correlation

Requirements

macOS (iMessage is only available on macOS)
Deno 2.x or later
Read access to ~/Library/Messages/chat.db, or to a custom database configured with IMESSAGE_DB_PATH
Read access to ~/Library/Application Support/AddressBook/ (for contacts search)

Packages

@wyattjoh/imessage

Core library for accessing iMessage data:

deno add @wyattjoh/imessage

import { openMessagesDatabase, searchMessages } from "@wyattjoh/imessage";

const db = await openMessagesDatabase();
const results = await searchMessages(db, { query: "hello" });
db.close();

Часто задаваемые вопросы

У этого сервера пока нет списка инструментов.

Выберите клиент, чтобы установить wyattjoh/imessage-mcp:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "wyattjoh-imessage-mcp-sqc0dpitp2": {
      "args": [
        "run",
        "--allow-read",
        "--allow-env",
        "--allow-sys",
        "--allow-ffi",
        "jsr:@wyattjoh/imessage-mcp"
      ],
      "command": "deno"
    }
  }
}

Cursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "wyattjoh-imessage-mcp-sqc0dpitp2": {
      "args": [
        "run",
        "--allow-read",
        "--allow-env",
        "--allow-sys",
        "--allow-ffi",
        "jsr:@wyattjoh/imessage-mcp"
      ],
      "command": "deno"
    }
  }
}

VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "wyattjoh-imessage-mcp-sqc0dpitp2": {
      "type": "stdio",
      "args": [
        "run",
        "--allow-read",
        "--allow-env",
        "--allow-sys",
        "--allow-ffi",
        "jsr:@wyattjoh/imessage-mcp"
      ],
      "command": "deno"
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"wyattjoh-imessage-mcp-sqc0dpitp2\",\"type\":\"stdio\",\"args\":[\"run\",\"--allow-read\",\"--allow-env\",\"--allow-sys\",\"--allow-ffi\",\"jsr:@wyattjoh/imessage-mcp\"],\"command\":\"deno\"}"

Claude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "wyattjoh-imessage-mcp-sqc0dpitp2": {
      "args": [
        "run",
        "--allow-read",
        "--allow-env",
        "--allow-sys",
        "--allow-ffi",
        "jsr:@wyattjoh/imessage-mcp"
      ],
      "command": "deno"
    }
  }
}

Claude Code

Добавьте сервер одной командой в терминале:

claude mcp add wyattjoh-imessage-mcp-sqc0dpitp2 -- deno run --allow-read --allow-env --allow-sys --allow-ffi jsr:@wyattjoh/imessage-mcp

Либо через JSON-конфиг:

claude mcp add-json wyattjoh-imessage-mcp-sqc0dpitp2 "{\"args\":[\"run\",\"--allow-read\",\"--allow-env\",\"--allow-sys\",\"--allow-ffi\",\"jsr:@wyattjoh/imessage-mcp\"],\"command\":\"deno\"}"

Codex

Добавьте сервер командой в терминале:

codex mcp add wyattjoh-imessage-mcp-sqc0dpitp2 -- deno run --allow-read --allow-env --allow-sys --allow-ffi jsr:@wyattjoh/imessage-mcp

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.wyattjoh-imessage-mcp-sqc0dpitp2]
command = "deno"
args = ["run", "--allow-read", "--allow-env", "--allow-sys", "--allow-ffi", "jsr:@wyattjoh/imessage-mcp"]

Perplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

Откройте Настройки аккаунта → Connectors.
Установите вспомогательное приложение PerplexityXPC (один раз).
Нажмите Add Connector → вкладка Simple.
В поле Server Name укажите wyattjoh/imessage-mcp, а в поле команды запуска — строку ниже:

deno run --allow-read --allow-env --allow-sys --allow-ffi jsr:@wyattjoh/imessage-mcp

Нажмите Save и дождитесь статуса Running.

Windsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "wyattjoh-imessage-mcp-sqc0dpitp2": {
      "args": [
        "run",
        "--allow-read",
        "--allow-env",
        "--allow-sys",
        "--allow-ffi",
        "jsr:@wyattjoh/imessage-mcp"
      ],
      "command": "deno"
    }
  }
}

Cline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "wyattjoh-imessage-mcp-sqc0dpitp2": {
      "args": [
        "run",
        "--allow-read",
        "--allow-env",
        "--allow-sys",
        "--allow-ffi",
        "jsr:@wyattjoh/imessage-mcp"
      ],
      "command": "deno",
      "disabled": false,
      "autoApprove": []
    }
  }
}

Continue

Создайте файл в .continue/mcpServers/ (например wyattjoh-imessage-mcp-sqc0dpitp2.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: wyattjoh-imessage-mcp-sqc0dpitp2
    command: deno
    args:
      - "run"
      - "--allow-read"
      - "--allow-env"
      - "--allow-sys"
      - "--allow-ffi"
      - "jsr:@wyattjoh/imessage-mcp"

Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "wyattjoh-imessage-mcp-sqc0dpitp2": {
      "args": [
        "run",
        "--allow-read",
        "--allow-env",
        "--allow-sys",
        "--allow-ffi",
        "jsr:@wyattjoh/imessage-mcp"
      ],
      "command": "deno"
    }
  }
}

Конфиг для установки сервера

{
  "command": "deno",
  "args": [
    "run",
    "--allow-read",
    "--allow-env",
    "--allow-sys",
    "--allow-ffi",
    "jsr:@wyattjoh/imessage-mcp"
  ]
}