Servidor MCP de iMessage

⚠️ DESCARGO DE RESPONSABILIDAD: ÚSELO BAJO SU PROPIA RESPONSABILIDAD ⚠️

Este software se proporciona tal cual, sin garantías de ningún tipo.

Un servidor MCP que utiliza AppleScript para enviar iMessages y administrar contactos.

Este servidor utiliza AppleScript para interactuar con las apps de Mensajes y Contactos de macOS mediante el Protocolo de Contexto de Modelo (MCP). Encapsula los comandos de AppleScript en un servidor TypeScript para permitirle:

• Ver y buscar sus contactos

• Enviar iMessages a contactos o números de teléfono

• Recibir confirmación cuando se envíen los mensajes

Características

Recursos

• Accede a tus contactos a través contacts://all

• Ver detalles de contacto, incluidos nombres, números de teléfono y direcciones de correo electrónico

• Todos los datos permanecen locales en su máquina

Herramientas

• search_contacts - Encuentra contactos por nombre, teléfono o correo electrónico

  • Toma una consulta de búsqueda y devuelve contactos coincidentes

  • Busca nombres, números de teléfono y direcciones de correo electrónico.

• send_message - Envía un iMessage

  • Toma el destinatario (teléfono/correo electrónico) y el contenido del mensaje.

  • Se envía a través de tu aplicación de Mensajes local

  • Devuelve confirmación o detalles de error

Related MCP server: Gmail MCP Server

Instalación

1. Instalar dependencias:

npm install

2. Construir el servidor:

npm run build

3. Configurar Claude Desktop para utilizar el servidor:

En MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "imessage": {
      "command": "node",
      "args": ["/path/to/imessage-server/build/server.js"]
    }
  }
}

4. Reiniciar Claude Desktop

5. Otorgar permisos cuando se le solicite:

   • Acceso a contactos

   • Acceso a mensajes

Uso

Una vez instalado, podrás hablar con Claude Desktop de forma natural:

• "Muéstrame mis contactos"

• "Buscar contactos llamados Marissa"

• Envía un mensaje al 555-0123 diciendo que estaré allí en 10 minutos.

• Envíale un iMessage a Alice preguntándole si aún podemos almorzar.

Notas de seguridad

• Todas las operaciones ocurren localmente en su máquina.

• No se envían datos de contacto ni de mensajes a servidores externos

• El servidor requiere permisos de macOS para acceder a Contactos y Mensajes

• Los mensajes se envían a través de tu cuenta de iMessage

Desarrollo

Para el desarrollo y la depuración, utilice el Inspector MCP:

npx @modelcontextprotocol/inspector node build/server.js

Requisitos

• macOS (para la integración de Mensajes y Contactos)

• Node.js 18 o superior

• Escritorio de Claude

• Cuenta de iMessage activa

Solución de problemas

Si los mensajes no se envían:

1. Comprobar que la aplicación Mensajes esté iniciada sesión

2. Verificar que se concedan los permisos

3. Busque errores en los registros de Claude Desktop:

tail -f ~/Library/Logs/Claude/mcp*.log