imessage-mcp

imessage-mcp

Busca y lee tu historial de Messages desde Claude, Codex, Cursor, VS Code y cualquier otro cliente MCP.

Solo lectura. Se ejecuta en tu Mac. Sin cuentas, sin servicio en la nube, nada que compilar.

• Encuentra mensajes por palabras, texto exacto o frases en iMessage, SMS, MMS y RCS
• Lee conversaciones completas con ediciones, mensajes no enviados, reacciones, respuestas y confirmaciones de lectura
• Muestra fotos que te han enviado, con los datos de ubicación eliminados
• Se mantiene al día con los mensajes nuevos mediante un feed de cambios, y responde preguntas sobre conteos y tiempos de respuesta

Instalación

Requisitos: macOS 14 o posterior. Node.js 24.16 o posterior para instalaciones con npx (Claude Desktop trae el suyo propio).

Configuración estándar, para cualquier cliente que lea JSON de mcpServers:

{
  "mcpServers": {
    "imessage": {
      "command": "npx",
      "args": ["-y", "imessage-mcp@latest"]
    }
  }
}

Luego dale a la aplicación que lo ejecuta Acceso total al disco: Configuración del Sistema > Privacidad y Seguridad > Acceso total al disco, activa la aplicación (Claude, tu terminal, Cursor, VS Code, ...), luego ciérrala por completo y vuelve a abrirla. ¿No estás seguro de qué aplicación? Ejecuta npx -y imessage-mcp@latest doctor desde la terminal de esa aplicación y te lo dirá. Hasta que se conceda el acceso, cada herramienta responde con estos mismos pasos.

amp mcp add imessage -- npx -y imessage-mcp@latest

claude mcp add --scope user imessage -- npx -y imessage-mcp@latest

codex mcp add imessage -- npx -y imessage-mcp@latest

[mcp_servers.imessage]
command = "npx"
args = ["-y", "imessage-mcp@latest"]

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "imessage": { "type": "local", "command": ["npx", "-y", "imessage-mcp@latest"], "enabled": true }
  }
}

code --add-mcp '{"name":"imessage","command":"npx","args":["-y","imessage-mcp@latest"]}'

Si una aplicación con interfaz gráfica informa que npx no se encontró, no puede ver tu instalación de Node: usa la ruta completa de which npx como command.

Cómo usarlo

Pregunta en palabras simples: "ponme al día con mis mensajes", "encuentra el mensaje sobre la reserva de la cena", "¿qué tan rápido suele responder Sam?". También hay tres indicaciones en el menú de indicaciones de tu cliente:

Los clientes que adjuntan recursos pueden usar imessage://conversations y imessage://conversations/{chat_id}.

Herramientas

Cada herramienta es de solo lectura y está marcada como readOnlyHint. Los resultados usan identificadores simples (message_id, chat_id, attachment_id) que puedes pasar entre herramientas.

Configuración

Añade opciones a args, por ejemplo ["-y", "imessage-mcp@latest", "--privacy", "redacted"].

Privacidad y seguridad

• Solo lectura. El servidor abre la base de datos de Messages en modo de solo lectura y no tiene ninguna herramienta que envíe, edite, reaccione o marque algo como leído.
• Local. Sin cuentas, telemetría ni análisis. La única solicitud de red es una verificación de versión opcional al registro de npm.
• Tu cliente ve lo que pides. Los resultados van al cliente MCP que usas y a su proveedor de modelos, bajo sus políticas. --privacy redacted o aggregate limita lo que sale del servidor.
• Índice de búsqueda. Se construye en tu Mac y se almacena en caché cifrado en ~/Library/Caches/imessage-mcp, con una clave derivada de tu base de datos de Messages, por lo que solo se abre para una aplicación que ya puede leer tus mensajes. Eliminarlo siempre es seguro.
• Contenido no confiable. Los mensajes pueden contener texto escrito para manipular una IA. El servidor indica a los clientes que traten todo el contenido de los mensajes como datos, nunca como instrucciones.

Detalles: SECURITY.md y PRIVACY.md.

Desarrollo

npm ci
npm test      # unit tests on synthetic Messages databases
npm run e2e   # launches the built server over stdio and HTTP
npm run perf  # one-million-message performance gates

Las pruebas usan solo datos sintéticos. Consulta CONTRIBUTING.md.

Licencia

MIT