iMessage MCP Server

local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

  • Enables sending iMessages to contacts or phone numbers from your Mac, with confirmation when messages are sent.

  • Provides access to macOS Contacts app for viewing, searching, and managing contacts, including names, phone numbers, and email addresses.

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

Instalación

  1. Instalar dependencias:
npm install
  1. Construir el servidor:
npm run build
  1. 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"] } } }
  1. Reiniciar Claude Desktop
  2. 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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

Un servidor local que permite a Claude Desktop interactuar con sus aplicaciones Contactos y Mensajes de macOS, lo que le permite buscar contactos y enviar iMessages a través de comandos de lenguaje natural.

  1. Features
    1. Resources
    2. Tools
  2. Installation
    1. Usage
      1. Security Notes
        1. Development
          1. Requirements
            1. Troubleshooting
              ID: l9nb64rn7g