WhatsApp Chat Reader MCP server
✓ VerifiziertErmöglicht es einem AI-Client, den lokalen WhatsApp-Chatverlauf durch Lesen der lokalen SQLite-Datenbank zusammenzufassen, zu durchsuchen und zu analysieren.
Auch bekannt als NabheetCloud/wa-chat-reader, wa-chat-reader
- Stars
- 1
- Tools
- 2
- Downloads, 30 Tage
- 132
- Neueste Version
- 0.1.0
- Letzter Commit
- 5. Juli 2026
- Lizenz
- MIT
Was ist WhatsApp Chat Reader MCP?
Ermöglicht es einem AI-Client, den lokalen WhatsApp-Chatverlauf durch Lesen der lokalen SQLite-Datenbank zusammenzufassen, zu durchsuchen und zu analysieren. Er stellt 2 Tools bereit, etwa get_whatsapp_messages, get_whatsapp_chat_list.
Zusammenfassung generiert aus dem README des Projekts
Über WhatsApp Chat Reader MCP server
Dieses Tool ermöglicht es dir, deine privaten WhatsApp-Konversationen direkt aus einem AI-Client heraus zusammenzufassen und zu durchsuchen. Es funktioniert, indem es die lokale ChatStorage.sqlite-Datenbank liest, die von der WhatsApp Desktop-App auf macOS, Windows oder Linux verwendet wird. Da der Server vollständig auf deinem Rechner läuft und keinen Netzwerkcode enthält, bleiben deine Nachrichtendaten lokal und werden nur mit dem spezifischen MCP-Client geteilt, den du verwendest.
Entwickler können diesen Server mit Python und uv an Clients wie Claude Desktop oder Claude Code anbinden. Der Server stellt zwei spezifische Tools bereit: get_whatsapp_messages zum Abrufen von Text aus persönlichen Chats oder Gruppenchats und get_whatsapp_chat_list zum Anzeigen aktiver Chatnamen. Um Privatsphäre und Performance zu schützen, begrenzt die Umgebungsvariable WHATSAPP_MAX_DAYS, wie weit die KI in die Vergangenheit zurückblicken kann (Standardwert ist ein 30-Tage-Fenster). Nutzer auf macOS müssen dem Prozess den vollen Festplattenzugriff gewähren, um auf den geschützten Datenbank-Container zuzugreifen.
Was du damit machen kannst
- 1Aktuelle Gruppenaktivitäten zusammenfassenBitte deinen AI-Client um eine Zusammenfassung der Nachrichten aus bestimmten Gruppenchats der letzten Tage.
- 2Aktive Konversationen identifizierenFordere eine Liste aller WhatsApp-Chats an, an denen du in der aktuellen Woche teilgenommen hast.
- 3Messaging-Muster analysierenErstelle ein lokales HTML-Dashboard, um dein Nachrichtenaufkommen und deine täglichen Rhythmen zu visualisieren.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du WhatsApp Chat Reader MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenWhatsApp Chat Reader MCP in Claude Code installieren
$ claude mcp add wa-chat-reader -- uvx wa-chat-readerWhatsApp Chat Reader MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}WhatsApp Chat Reader MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"wa-chat-reader": {
"type": "stdio",
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}WhatsApp Chat Reader MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"wa-chat-reader","type":"stdio","command":"uvx","args":["wa-chat-reader"]}'WhatsApp Chat Reader MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}WhatsApp Chat Reader MCP in Codex installieren
$ codex mcp add wa-chat-reader -- uvx wa-chat-readerWhatsApp Chat Reader MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.wa-chat-reader] command = "uvx" args = ["wa-chat-reader"]
WhatsApp Chat Reader MCP in Gemini CLI installieren
$ gemini mcp add -s user wa-chat-reader uvx -- wa-chat-readerWhatsApp Chat Reader MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}WhatsApp Chat Reader MCP tools 2
Erkannt aus dem READMEget_whatsapp_messagesget_whatsapp_chat_list
| get_whatsapp_messages | — | |
| get_whatsapp_chat_list | — |
Konfiguration
WHATSAPP_BACKUP_PATHSSemicolon-separated fallback database paths, tried after the primary paths.
WHATSAPP_DB_PATHSSemicolon-separated paths to ChatStorage.sqlite. If unset, a platform default is used.
WHATSAPP_DEBUGSet to 'true' for verbose logging to stderr.
WHATSAPP_LOG_FILEOptional path to also write logs to a file.
WHATSAPP_MAX_DAYSMaximum look-back window in days a caller may request.
| Name | Beschreibung | Typ |
|---|---|---|
| WHATSAPP_BACKUP_PATHS | Semicolon-separated fallback database paths, tried after the primary paths. | |
| WHATSAPP_DB_PATHS | Semicolon-separated paths to ChatStorage.sqlite. If unset, a platform default is used. | |
| WHATSAPP_DEBUG | Set to 'true' for verbose logging to stderr. | |
| WHATSAPP_LOG_FILE | Optional path to also write logs to a file. | |
| WHATSAPP_MAX_DAYS | Maximum look-back window in days a caller may request. |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarnabheetcloud/wa-chat-reader is public and reachablegithub.com/nabheetcloud/wa-chat-reader ↗Bestanden
- Paket nennt dieses Repository als Quellewa-chat-reader names nabheetcloud/wa-chat-reader as sourcepypi.org/project/wa-chat-reader/ ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)No build attestation published for this releaseNicht geprüft
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-07-05github.com/nabheetcloud/wa-chat-reader ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from wa-chat-readerBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten29 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell2 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehenwa-chat-reader
Unofficial, read-only MCP server for your local WhatsApp chat history.
wa-chat-reader reads the WhatsApp ChatStorage.sqlite database that the WhatsApp
desktop app keeps on your machine and exposes two tools to any MCP client (Claude
Code, Claude Desktop, etc.) so you can summarize, search, and reason over your own
messages. Everything runs locally — no data ever leaves your computer.
⚠️ Not affiliated with, endorsed by, or connected to WhatsApp or Meta. "WhatsApp" is a trademark of Meta Platforms, Inc. This is an independent, unofficial tool that only reads a database WhatsApp already stores on your device.
Privacy & security
This tool touches highly sensitive data — your private conversations. Read this first.
- Read-only. The database is opened with SQLite
mode=ro&immutable=1; the server never writes to, modifies, or deletes anything. - Local-only. There is no network code. Messages are returned to your MCP client and nowhere else. Whatever LLM/client you connect will, of course, see the message text you ask it to read — you control that by choosing which client to run.
- Your consent, your data. Only run this against your own device and your own chats. Do not use it to access anyone else's messages.
- macOS access. The WhatsApp database lives in a protected group container. The
process running this server needs Full Disk Access
(System Settings → Privacy & Security → Full Disk Access), or point
WHATSAPP_DB_PATHSat a readable copy you export yourself. - Scope control.
WHATSAPP_MAX_DAYS(default 30) caps how far back any single call can read.
Install
Requires Python ≥ 3.10. Recommended: uv so the server
runs in an isolated environment.
# one-shot run (no install)
uvx wa-chat-reader
# or install with pip
pip install wa-chat-reader
wa-chat-reader
Use in Claude Code
claude mcp add wa-chat-reader -- uvx wa-chat-reader
Or install as a plugin (see the marketplace section below), then ask Claude things like:
- "Summarize my unread WhatsApp group chats from the last 3 days."
- "List the WhatsApp chats I've been active in this week."
Configuration
All configuration is via environment variables (all optional):
| Variable | Default | Description |
|---|---|---|
WHATSAPP_DB_PATHS |
platform default | ;-separated candidate paths to ChatStorage.sqlite (first readable wins) |
WHATSAPP_BACKUP_PATHS |
— | ;-separated fallback paths, tried after the primary paths |
WHATSAPP_MAX_DAYS |
30 |
Max look-back window (days) a caller may request |
WHATSAPP_DEBUG |
false |
true for verbose logging to stderr |
WHATSAPP_LOG_FILE |
— | Optional path to also write logs to a file |
Default database locations:
| OS | Path |
|---|---|
| macOS | ~/Library/Group Containers/group.net.whatsapp.WhatsApp.shared/ChatStorage.sqlite |
| Windows | ~/AppData/Roaming/WhatsApp/Databases/ChatStorage.sqlite |
| Linux | ~/.local/share/whatsapp/ChatStorage.sqlite |
Tools
| Tool | Description |
|---|---|
get_whatsapp_messages |
Concatenated message text from group and personal chats within a look-back window. Params: days (1–max), chat_type (all/groups/personal). Read-only. |
get_whatsapp_chat_list |
Active chat names (no message bodies) within a look-back window. Param: days. Read-only. |
Both tools are annotated readOnlyHint: true.
Bonus: activity dashboard
whatsapp_dashboard.py renders a self-contained, offline HTML dashboard of your
messaging activity (volume over time, daily/weekly rhythm, top chats) straight from
the same database:
python3 whatsapp_dashboard.py # -> whatsapp_dashboard.html
The generated HTML contains real contact names — it is git-ignored and meant to stay local.
Develop
git clone https://github.com/NabheetCloud/wa-chat-reader
cd wa-chat-reader
pip install -e .
python3 simple_whatsapp_mcp.py # run from source without installing
License
MIT © 2026 Nabheet Madan
WhatsApp Chat Reader MCP Fragen
Wie füge ich WhatsApp Chat Reader MCP zu Claude Code hinzu?
Führe claude mcp add wa-chat-reader -- uvx wa-chat-reader in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich WhatsApp Chat Reader MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet WhatsApp Chat Reader MCP?
Er stellt 2 Tools bereit, darunter get_whatsapp_messages, get_whatsapp_chat_list.
Werden meine WhatsApp-Daten in die Cloud gesendet?
Nein, alles läuft lokal und es werden keine Daten von deinem Computer übertragen.
Kann dieser Server meine Nachrichten ändern oder löschen?
Nein, der Server ist read-only und nutzt den SQLite-Modus, der das Schreiben, Ändern oder Löschen von Daten verhindert.
Welche Berechtigungen werden unter macOS benötigt?
Der Prozess benötigt den vollen Festplattenzugriff (Full Disk Access) in deinen Systemeinstellungen, da sich die WhatsApp-Datenbank in einem geschützten Group Container befindet.
Wie weit in die Vergangenheit kann die KI meine Nachrichten lesen?
Das Zeitfenster wird durch die Variable WHATSAPP_MAX_DAYS begrenzt, die standardmäßig auf 30 Tage eingestellt ist.