imessage-mcp

Ein schreibgeschützter MCP-Server, der Ihre iMessage-Daten für Claude Code und Claude Desktop verfügbar macht, inklusive automatischer Auflösung von Kontaktnamen.

Einrichtung

1. Installation

cd ~/workspace/imessage-mcp
python3.12 -m venv .venv
source .venv/bin/activate
pip install -e .

2. Vollständigen Festplattenzugriff gewähren

Der Server muss ~/Library/Messages/chat.db und die Kontakte-Datenbank lesen. Gewähren Sie der App, die den Server ausführt, Vollständigen Festplattenzugriff:

1. Öffnen Sie Systemeinstellungen → Datenschutz & Sicherheit → Vollständiger Festplattenzugriff

2. Für Claude Code: Fügen Sie Ihre Terminal-App hinzu (z. B. Terminal, iTerm2, Ghostty)

3. Für Claude Desktop: Fügen Sie die Claude-App hinzu

3. Claude Code konfigurieren

Fügen Sie dies zu ~/.claude/settings.json hinzu:

{
  "mcpServers": {
    "imessage": {
      "command": "/Users/jaredmoskowitz/workspace/imessage-mcp/.venv/bin/python",
      "args": ["-m", "imessage_mcp"]
    }
  }
}

4. Claude Desktop konfigurieren

Fügen Sie dies zu ~/Library/Application Support/Claude/claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "imessage": {
      "command": "/Users/jaredmoskowitz/workspace/imessage-mcp/.venv/bin/python",
      "args": ["-m", "imessage_mcp"]
    }
  }
}

Related MCP server: imessage-rich-search

Tools

list_chats

Listet Ihre iMessage-Chats sortiert nach letzter Aktivität auf.

• limit (optional, Standard 50): Maximale Anzahl der zurückzugebenden Chats

get_messages

Ruft Nachrichten aus einem bestimmten Chat ab.

• chat_id (erforderlich): Chat-Identifikator aus list_chats

• limit (optional, Standard 50): Maximale Anzahl der Nachrichten

• since (optional): ISO-Datumszeichenfolge — nur Nachrichten nach diesem Datum

search_messages

Durchsucht alle Chats nach Nachrichten, die ein Schlüsselwort enthalten.

• query (erforderlich): Suchtext

• limit (optional, Standard 50): Maximale Anzahl der Ergebnisse

Anwendungsbeispiele

"List my group chats" "Get the last 20 messages from my Business Ideas chat" "Search my messages for 'startup idea'"