mac_messages_mcp MCP — Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Intelligente Nachrichtenübermittlung: Wählt automatisch iMessage für Apple und SMS/RCS für Android aus
Lesen Sie Nachrichten mit zeitbasierter Filterung, Kontaktsuche und Fuzzy-Matching
iMessage availability check before sending
Anhangsverarbeitung und Gruppenchat-Unterstützung
macOS 11+, Python 3.10+ — available via pip or uvx

Live-Demo

In der Praxis

mac-messages-mcp-2.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/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"
      ]
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

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

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

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

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

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

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

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

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

In context_servers hinzufügen. Zed lädt beim Speichern neu.

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

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: mac_messages_mcp

So durchsuchen Sie Ihren iMessage-Verlauf mit KI-Unterstützung

👤 Mac-Benutzer, die bestimmte Konversationen oder Informationen finden möchten ⏱ ~5 min beginner

Wann einsetzen: Sie müssen eine Nachricht von vor Wochen finden, können sich aber nicht erinnern, wer sie wann gesendet hat.

Voraussetzungen

Vollständiger Festplattenzugriff gewährt — Systemeinstellungen → Datenschutz und Sicherheit → Vollständiger Festplattenzugriff → Terminal oder Ihren MCP-Host hinzufügen
mac-messages-mcp installiert — uvx mac-messages-mcp oder uv pip installieren mac-messages-mcp

Ablauf

Nachrichten durchsuchen

Durchsuchen Sie meine Nachrichten nach Unterhaltungen zum Thema „Abendessenreservierung“ in den letzten zwei Wochen. Zeigen Sie, wer sie gesendet hat, und den vollständigen Kontext.✓ Kopiert

→ Abgleichen von Nachrichten mit Absender, Zeitstempeln und umgebendem Kontext
Erhalten Sie Aktuelles von einem Kontakt

Zeig mir meine letzten 20 Nachrichten mit John Smith.✓ Kopiert

→ Konversationsthread mit Zeitstempeln

Ergebnis: Sie haben die spezifische Nachricht oder Konversation gefunden, nach der Sie gesucht haben.

Fallstricke

Vollständiger Festplattenzugriff wurde nicht gewährt — Ohne diese Berechtigung kann der MCP-Server die Nachrichtendatenbank nicht lesen. Gewähren Sie es in den Systemeinstellungen.

Senden Sie Nachrichten an Kontakte mit Claude

👤 Mac-Benutzer, die Nachrichten freihändig senden möchten ⏱ ~2 min beginner

Wann einsetzen: Sie möchten über Claude Nachrichten verfassen und versenden.

Voraussetzungen

mac-messages-mcp mit vollem Festplattenzugriff — Aufbau wie oben

Ablauf

Überprüfen Sie die Verfügbarkeit von iMessage

Kann ich +1-555-0123 über iMessage erreichen?✓ Kopiert

→ Verfügbarkeitsstatus (iMessage oder SMS)
Senden Sie eine Nachricht

Schicken Sie Ihrer Mutter eine Nachricht mit der Aufschrift „Ich komme 15 Minuten zu spät, bis bald!“✓ Kopiert

→ Bestätigung der gesendeten Nachricht mit Versandart

Ergebnis: Nachricht wird über den entsprechenden Kanal übermittelt.

Fallstricke

Kontaktnamen können mehrdeutig sein — Verwenden Sie Telefonnummern oder E-Mail-Adressen für eine präzise Zielgruppenansprache

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

mac-messages-mcp-2 + filesystem

Exportieren Sie Nachrichtenkonversationen zur Sicherung in Textdateien

Exportieren Sie meine Nachrichten des letzten Monats mit dem Gruppenchat „Familie“ nach ~/messages-backup/family.txt.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen
send_message	recipient: str, content: str	Senden Sie eine Nachricht per iMessage oder SMS
get_recent_messages	contact?: str, limit?: int, time_range?: str	Rufen Sie aktuelle Nachrichten mit optionalen Filtern ab
check_imessage_availability	recipient: str	Überprüfen Sie, ob ein Empfänger iMessage empfangen kann

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: N/A – liest die lokale macOS-Nachrichtendatenbank
Tokens pro Aufruf: 200–1000 Token pro Abfrage
Kosten in €: Kostenlos – für den Versand gelten die Standardtarife für iMessage/SMS
Tipp: Verwenden Sie zeitbasierte Filter, um den Suchumfang einzuschränken und die Token-Nutzung zu reduzieren.

Sicherheit

Rechte, Secrets, Reichweite

Minimale Scopes: Full Disk Access on macOS

Credential-Speicherung: Keine Anmeldeinformationen erforderlich – greift direkt auf die lokale Nachrichtendatenbank zu

Datenabfluss: Liest aus der lokalen ~/Library/Messages/chat.db. Der Versand erfolgt über das macOS Messages Framework.

Full Disk Access gewährt umfassenden Dateizugriff. Der MCP-Server liest nur die Nachrichtendatenbank, aber die Berechtigung selbst ist leistungsstark.
Das Versenden von Nachrichten übernimmt Ihre Aufgabe – alle Nachrichten werden von Ihrem Konto aus angezeigt.
Message history contains sensitive personal data. Ensure your AI interactions are private.

Fehlerbehebung

Häufige Fehler und Lösungen

Permission denied reading Messages database

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

Prüfen: ls ~/Library/Messages/chat.db

Contact not found

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

Prüfen: 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.

Prüfen: Try sending a message manually from Messages.app

Alternativen

mac_messages_mcp vs. andere

Alternative	Wann stattdessen	Kompromiss
applescript-mcp	You want broader macOS control beyond just Messages	Can do everything plus more, but with full system access risks

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen