Mensajes de Mac MCP

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

Descargas de PyPI

Diagrama de una computadora Mac con el archivo tex_FvvnmbaBTFeKy6F2GMlLqA_IfCBMgJARcia1WTH7FaqwA

Características

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

Related MCP server: iMCP

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.