mac_messages_mcp MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Smart message delivery: auto-selects iMessage for Apple, SMS/RCS for Android
Read messages with time-based filtering, contact search, and fuzzy matching
iMessage availability check before sending
Attachment processing and group chat support
macOS 11+, Python 3.10+ — available via pip or uvx

Demo en vivo

Cómo se ve en la práctica

mac-messages-mcp-2.replay ▶ listo

0/0

Instalar

Elige tu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mac-messages-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mac-messages-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  }
}

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mac-messages-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  }
}

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mac-messages-mcp-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "mac-messages-mcp-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/carterlasalle/mac_messages_mcp"
      ]
    }
  ]
}

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

{
  "context_servers": {
    "mac-messages-mcp-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/carterlasalle/mac_messages_mcp"
        ]
      }
    }
  }
}

Añádelo a context_servers. Zed recarga en caliente al guardar.

claude mcp add mac-messages-mcp-2 -- TODO 'See README: https://github.com/carterlasalle/mac_messages_mcp'

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: mac_messages_mcp

How to search your iMessage history with AI assistance

👤 Mac users who want to find specific conversations or information ⏱ ~5 min beginner

Cuándo usarlo: You need to find a message from weeks ago but can't remember who sent it or when.

Requisitos previos

Full Disk Access granted — System Settings → Privacy & Security → Full Disk Access → add Terminal or your MCP host
mac-messages-mcp installed — uvx mac-messages-mcp or uv pip install mac-messages-mcp

Flujo

Search messages

Search my messages for conversations about 'dinner reservation' in the last 2 weeks. Show who sent them and the full context.✓ Copiado

→ Matching messages with sender, timestamps, and surrounding context
Get recent from a contact

Show me my last 20 messages with John Smith.✓ Copiado

→ Conversation thread with timestamps

Resultado: Found the specific message or conversation you were looking for.

Errores comunes

Full Disk Access not granted — The MCP server can't read the Messages database without this permission. Grant it in System Settings.

Send messages to contacts using Claude

👤 Mac users who want to send messages hands-free ⏱ ~2 min beginner

Cuándo usarlo: You want to compose and send messages through Claude.

Requisitos previos

mac-messages-mcp with Full Disk Access — Set up as above

Flujo

Check iMessage availability

Can I reach +1-555-0123 via iMessage?✓ Copiado

→ Availability status (iMessage or SMS)
Send a message

Send a message to Mom saying 'Running 15 minutes late, see you soon!'✓ Copiado

→ Message sent confirmation with delivery method

Resultado: Message delivered via the appropriate channel.

Errores comunes

Contact names may be ambiguous — Use phone numbers or email addresses for precise targeting

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

mac-messages-mcp-2 + filesystem

Export message conversations to text files for backup

Export my last month's messages with the 'Family' group chat to ~/messages-backup/family.txt.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar
send_message	recipient: str, content: str	Send a message via iMessage or SMS
get_recent_messages	contact?: str, limit?: int, time_range?: str	Retrieve recent messages with optional filters
check_imessage_availability	recipient: str	Check if a recipient can receive iMessage

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: N/A — reads local macOS Messages database
Tokens por llamada: 200–1000 tokens per query
Monetario: Free — standard iMessage/SMS rates apply for sending
Consejo: Use time-based filters to limit search scope and reduce token usage.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Full Disk Access on macOS

Almacenamiento de credenciales: No credentials needed — accesses local Messages database directly

Salida de datos: Reads from local ~/Library/Messages/chat.db. Sending goes through macOS Messages framework.

Full Disk Access grants broad file access. The MCP server only reads the Messages database, but the permission itself is powerful.
Sending messages acts as you — all messages appear from your account.
Message history contains sensitive personal data. Ensure your AI interactions are private.

Resolución de problemas

Errores comunes y soluciones

Permission denied reading Messages database

Grant Full Disk Access to Terminal (or your MCP host app) in System Settings → Privacy & Security → Full Disk Access.

Verificar: ls ~/Library/Messages/chat.db

Contact not found

Use phone number or email instead of display name. Fuzzy matching may not find all contacts.

Verificar: Try with the exact phone number

Message fails to send

Ensure Messages.app is configured and signed into your Apple ID. The MCP server uses macOS frameworks to send.

Verificar: Try sending a message manually from Messages.app

Alternativas

mac_messages_mcp vs otros

Alternativa	Cuándo usarla	Contrapartida
applescript-mcp	You want broader macOS control beyond just Messages	Can do everything plus more, but with full system access risks

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills