mensajes-mac-mcp

Mensajes de Mac MCP

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

$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

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.

Historia de las estrellas

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

local-only server

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

Tools

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

Related MCP Servers

Apple MCP Server
supermemoryai
A
security
A
license
A
quality
Enables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Last updated -
6
506
2,127
TypeScript
MIT License
YaVendió Toolsofficial
YaVendio
-
security
-
license
-
quality
An MCP-based messaging system that allows AI systems to interact with various messaging platforms through standardized tools for sending text, images, documents, buttons, and alerts.
Last updated -
Python
MCP Python Server
jatindera
-
security
F
license
-
quality
A Python-based implementation of the Model Context Protocol that enables communication between a model context management server and client through a request-response architecture.
Last updated -
Python
iMCP
loopwork
-
security
A
license
-
quality
A macOS app that provides an MCP server to your Messages, Contacts, and more
Last updated -
683
Apache 2.0

View all related MCP servers

mac-messages-mcp