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

Instalar dependencias:

npm install

Construir el servidor:

npm run build

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"]
    }
  }
}

Reiniciar Claude Desktop
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:

Comprobar que la aplicación Mensajes esté iniciada sesión
Verificar que se concedan los permisos
Busque errores en los registros de Claude Desktop:

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

You must be authenticated.

security – no known vulnerabilities

license - not found

quality - confirmed to work

local-only server

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

Tools

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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

MCP Relay Server
emiliobool
-
security
F
license
-
quality
This server allows integration with Discord, enabling message exchanges between Claude and a Discord channel using prompts and notifications.
Last updated -
TypeScript
Claude Desktop API MCP
mlobo2012
A
security
F
license
A
quality
A server that enables Claude Desktop users to access the Claude API directly, allowing them to bypass Professional Plan limitations and use advanced features like custom system prompts and conversation management.
Last updated -
1
5
Python
Gmail MCP
vinayak-mehta
-
security
A
license
-
quality
A server that allows Claude to search and retrieve emails from your Gmail account, supporting functions like searching emails, retrieving full content of specific emails, and listing recent messages.
Last updated -
2
Python
Apache 2.0
Gmail MCP Server
ajbr0wn
-
security
F
license
-
quality
An integration server that provides Claude Desktop access to Gmail, enabling users to view recent emails and search their Gmail inbox using natural language commands.
Last updated -
6
Python

View all related MCP servers

iMessage MCP Server