local-only server

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

Integrations

Allows reading and sending messages through the macOS Messages app, with capabilities to filter messages by contact and interact with iMessage conversations.
Provides access to the macOS Messages database, enabling interaction with the native messaging system on Mac computers.

Mensajes de Mac MCP

Un puente de Python para interactuar con la aplicación Mensajes de macOS usando MCP (Protocolo de contexto múltiple).

Características

Leer mensajes recientes desde la aplicación Mensajes de macOS
Filtrar mensajes por contacto
Enviar nuevos mensajes a través de iMessage
Acceder a los mensajes a través de una API

Prerrequisitos

macOS (probado en macOS 11+)
Python 3.10+
administrador de paquetes uv

Instalación de uv

Si estás en Mac, instala uv usando Homebrew:

brew install uv

De lo contrario, siga las instrucciones de instalación en el sitio web de uv .

⚠️ No proceda antes de instalar uv

Instalación

Permiso de acceso completo al disco

⚠️ Esta aplicación requiere permiso de acceso completo al disco para que su terminal o aplicación acceda a la base de datos de mensajes.

Para conceder acceso completo al disco:

Abra Preferencias del Sistema/Configuración > Seguridad y privacidad/Privacidad > Acceso completo al disco
Haga clic en el icono del candado para realizar cambios
Agregue su aplicación de terminal (Terminal, iTerm2, etc.) o Claude Desktop/Cursor a la lista
Reinicie su terminal o aplicación después de otorgar el permiso

Integración

Integración de escritorio de Claude

Vaya a Claude > Configuración > Desarrollador > Editar configuración > claude_desktop_config.json
Agregue la siguiente configuración:

{
    "mcpServers": {
        "messages": {
            "command": "uvx",
            "args": [
                "mac-messages-mcp"
            ]
        }
    }
}

Integración del cursor

Vaya a Configuración del cursor > MCP y pegue esto como comando:

uvx mac-messages-mcp

⚠️ Solo ejecute una instancia del servidor MCP (ya sea en Cursor o Claude Desktop), no en ambos

Opción 1: Instalar desde PyPI

uv pip install mac-messages-mcp

Opción 2: Instalar desde la fuente

# Clone the repository
git clone https://github.com/carterlasalle/mac_messages_mcp.git
cd mac_messages_mcp

# Install dependencies
uv install -e .

Uso

Como módulo

from mac_messages_mcp import get_recent_messages, send_message

# Get recent messages
messages = get_recent_messages(hours=48)
print(messages)

# Send a message
result = send_message(recipient="+1234567890", message="Hello from Mac Messages MCP!")
print(result)

Como herramienta de línea de comandos

# Run the MCP server directly
mac-messages-mcp

Desarrollo

Control de versiones

Este proyecto utiliza control de versiones semántico. Consulte VERSIONING.md para obtener más información sobre el funcionamiento del sistema de control de versiones y cómo publicar nuevas versiones.

Para subir la versión:

python scripts/bump_version.py [patch|minor|major]

Notas de seguridad

Esta aplicación accede directamente a la base de datos de Mensajes, que contiene comunicaciones personales. Úsela con responsabilidad y asegúrese de tener los permisos adecuados.

Licencia

Instituto Tecnológico de Massachusetts (MIT)

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Un puente de Python para interactuar con la app Mensajes de macOS mediante MCP (Protocolo de Contexto Múltiple). Instalación sencilla con uvx mac-messages-mcp.

Related Resources

Reddit Discussion about this server