Skip to main content
Glama
Sign In
deenesjakoruzh

mac-messages-mcp

by carterlasalle
GitHub
Python
MIT License
76
  • Apple
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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:

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

Integración

Integración de escritorio de Claude

  1. Vaya a Claude > Configuración > Desarrollador > Editar configuración > claude_desktop_config.json
  2. 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

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
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 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.

  1. Características
    1. Prerrequisitos
      1. Instalación de uv
    2. Instalación
      1. Permiso de acceso completo al disco
    3. Integración
      1. Integración de escritorio de Claude
      2. Integración del cursor
      3. Opción 1: Instalar desde PyPI
      4. Opción 2: Instalar desde la fuente
    4. Uso
      1. Como módulo
      2. Como herramienta de línea de comandos
    5. Desarrollo
      1. Control de versiones
    6. Notas de seguridad
      1. Licencia
        1. Contribuyendo
          1. Historia de las estrellas

            Related Resources

            Related MCP Servers

            • apple-notifier-mcp

              turlockmike
              A
              security
              A
              license
              A
              quality
              A simple MCP server that can send notifications on mac devices.
              Last updated -
              5
              9
              8
              TypeScript
              MIT License
              • Apple

            • MCP Server Python Template

              Cris-0k
              -
              security
              A
              license
              -
              quality
              A streamlined foundation for building Model Context Protocol servers in Python, designed to make AI-assisted development of MCP tools easier and more efficient.
              Last updated -
              13
              Python
              MIT License

            • Python Apple MCP

              jxnl
              -
              security
              F
              license
              -
              quality
              A Python server that enables interaction with macOS native applications (Contacts, Notes, Mail, Messages, Reminders, Calendar, and Maps) through AppleScript, featuring asynchronous operations and type-safe interfaces.
              Last updated -
              5
              Python
              • Apple

            • iMCP

              loopwork-ai
              -
              security
              A
              license
              -
              quality
              A macOS app that provides an MCP server to your Messages, Contacts, and more
              Last updated -
              559
              Apache 2.0
              • Apple

            View all related MCP servers

            Appeared in Searches

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/carterlasalle/mac_messages_mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server