WhatsApp MCP für macOS

Ein Model Context Protocol-Server, der Claude mit deinem WhatsApp verbindet. Lies Nachrichten, durchsuche Kontakte, sende Antworten – alles durch natürliche Konversation.

Funktionen

• Kontakte suchen — Finde jeden per Name oder Telefonnummer

• Nachrichten lesen — Erhalte Chatverläufe mit Datumsfilter und Suche

• Chats auflisten — Sieh dir aktuelle Konversationen mit ungelesenen Nachrichten an

• Nachrichten senden — Antworte direkt über Claude (mit QR-Authentifizierung)

• Echtzeit-Empfang — Erhalte Nachrichten, sobald sie ankommen

Voraussetzungen

• macOS mit installierter und angemeldeter WhatsApp-Desktop-App

• Python 3.10+

• Node.js 18+ (zum Senden von Nachrichten)

Installation

Mit pip

pip install whatsapp-mcp-macos

Aus dem Quellcode

git clone https://github.com/kalki-kgp/whatsapp-mcp.git
cd whatsapp-mcp
pip install -e .

Mit Claude Desktop verbinden

1. Konfigurationsdatei öffnen:

   open ~/Library/Application\ Support/Claude/claude_desktop_config.json

   Falls sie nicht existiert, erstelle sie.

2. Den WhatsApp MCP-Server hinzufügen:

   {
     "mcpServers": {
       "whatsapp": {
         "command": "python3",
         "args": ["-m", "whatsapp_mcp"]
       }
     }
   }

3. Claude Desktop neu starten (Cmd+Q, dann erneut öffnen)

4. Suche nach dem MCP-Tools-Symbol (🔨) in der Chateingabe – klicke darauf, um zu überprüfen, ob "whatsapp" aufgelistet ist

5. Chatten beginnen:

   • "Zeige meine letzten WhatsApp-Chats"

   • "Suche in Nachrichten nach Plänen für das Abendessen"

Mit Cursor verbinden

Füge dies zu .cursor/mcp.json in deinem Projekt hinzu:

{
  "mcpServers": {
    "whatsapp": {
      "command": "python3",
      "args": ["-m", "whatsapp_mcp"]
    }
  }
}

Starte Cursor neu und verwende WhatsApp-Tools im KI-Chat.

Verwendung

Nachrichten lesen (funktioniert sofort)

Frag einfach Claude:

• "Zeige meine letzten WhatsApp-Chats"

• "Suche nach Nachrichten über das Abendessen"

• "Was hat John gestern gesagt?"

• "Gib mir eine Zusammenfassung der ungelesenen Nachrichten"

Nachrichten senden (erfordert Bridge)

1. Starte die WhatsApp-Bridge:

   cd bridge && npm install && npm start

2. Bitte Claude, die Verbindung zu prüfen:

   • "Überprüfe den WhatsApp-Status"

3. Wenn ein QR-Code angezeigt wird, öffne die Daten-URL in einem Browser und scanne sie mit deinem Telefon

4. Sobald die Verbindung steht, kannst du senden:

   • "Sende eine Nachricht an Mama, dass ich mich verspäte"

   • "Antworte John mit 'klingt gut'"

Tools

Funktionsweise

Claude ──MCP──▶ WhatsApp MCP Server
                       │
                       ├──▶ Local SQLite DBs (read messages)
                       │    ~/Library/Group Containers/group.net.whatsapp.WhatsApp.shared/
                       │
                       └──▶ WhatsApp Bridge (:3010) ──▶ WhatsApp Web
                            (for sending)

Leseoperationen fragen die lokale WhatsApp-Datenbank direkt ab – schnell und offline verfügbar.

Sendeoperationen laufen über die Bridge, die sich mit WhatsApp Web unter Verwendung von Baileys verbindet.

Entwicklung

# Clone
git clone https://github.com/kalki-kgp/whatsapp-mcp.git
cd whatsapp-mcp

# Install in dev mode
pip install -e ".[dev]"

# Run server
python -m whatsapp_mcp

Datenschutz

• Alle Daten bleiben lokal – Nachrichten werden aus deiner eigenen WhatsApp-Datenbank gelesen

• Es werden keine Daten an externe Server gesendet (außer an WhatsApp Web beim Senden)

• Der MCP-Server läuft lokal auf deinem Rechner

Lizenz

MIT