imessage-mcp

Un servidor MCP de solo lectura que expone tus datos de iMessage a Claude Code y Claude Desktop, con resolución automática de nombres de contacto.

Configuración

1. Instalación

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

2. Conceder acceso completo al disco

El servidor necesita leer ~/Library/Messages/chat.db y la base de datos de Contactos. Concede Acceso completo al disco a la aplicación que ejecuta el servidor:

1. Abre Ajustes del Sistema → Privacidad y seguridad → Acceso completo al disco

2. Para Claude Code: añade tu aplicación de terminal (p. ej., Terminal, iTerm2, Ghostty)

3. Para Claude Desktop: añade la aplicación Claude

3. Configurar Claude Code

Añade a ~/.claude/settings.json:

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

4. Configurar Claude Desktop

Añade a ~/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

Herramientas

list_chats

Enumera tus chats de iMessage ordenados por actividad reciente.

• limit (opcional, predeterminado 50): máximo de chats a devolver

get_messages

Obtén mensajes de un chat específico.

• chat_id (obligatorio): identificador del chat de list_chats

• limit (opcional, predeterminado 50): máximo de mensajes

• since (opcional): cadena de fecha ISO — solo mensajes posteriores a esta fecha

search_messages

Busca en todos los chats mensajes que contengan una palabra clave.

• query (obligatorio): texto de búsqueda

• limit (opcional, predeterminado 50): máximo de resultados

Ejemplo de uso

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