WhatsApp Chat Reader MCP sunucusu
✓ DoğrulandıYerel SQLite veritabanını okuyarak bir AI istemcisinin yerel WhatsApp sohbet geçmişini özetlemesine, arama yapmasına ve bunlar üzerinde mantık yürütmesine olanak tanır.
Ayrıca bilinen adı NabheetCloud/wa-chat-reader, wa-chat-reader
- Yıldızlar
- 1
- Araçlar
- 2
- İndirmeler, 30 gün
- 132
- En son sürüm
- 0.1.0
- Son commit
- 5 Tem 2026
- Lisans
- MIT
WhatsApp Chat Reader MCP nedir?
Yerel SQLite veritabanını okuyarak bir AI istemcisinin yerel WhatsApp sohbet geçmişini özetlemesine, arama yapmasına ve bunlar üzerinde mantık yürütmesine olanak tanır. 2 araç sunar; örneğin get_whatsapp_messages, get_whatsapp_chat_list.
Özet, projenin README dosyasından oluşturuldu
WhatsApp Chat Reader MCP sunucusu hakkında
Bu araç, özel WhatsApp konuşmalarınızı bir AI istemcisi içerisinden özetlemenize ve arama yapmanıza olanak tanır. macOS, Windows veya Linux üzerinde WhatsApp masaüstü uygulaması tarafından kullanılan yerel ChatStorage.sqlite veritabanını okuyarak çalışır. Sunucu, ağ kodu olmadan tamamen kendi makinenizde çalıştığı için mesaj verileriniz yerel kalır ve yalnızca kullanmayı seçtiğiniz belirli MCP istemcisi ile paylaşılır.
Geliştiriciler, Python ve uv kullanarak bu sunucuyu Claude Desktop veya Claude Code gibi istemcilere bağlayabilirler. Sunucu iki özel araç sağlar: kişisel veya grup sohbetlerinden metin almak için get_whatsapp_messages ve aktif sohbet isimlerini görüntülemek için get_whatsapp_chat_list. Gizliliği ve performansı korumak için WHATSAPP_MAX_DAYS ortam değişkeni, AI'nın ne kadar geriye bakabileceğini sınırlar ve varsayılan olarak 30 günlük bir pencere sunar. macOS kullanıcıları, korumalı veritabanı konteynerine erişebilmek için işleme Tam Disk Erişimi izni vermelidir.
Neler yapabilirsiniz
- 1Son grup aktivitelerini özetleyinAI istemcinizden son birkaç gündeki belirli grup sohbetlerinden gelen mesajların bir özetini sunmasını isteyin.
- 2Aktif konuşmaları belirleyinİçinde bulunduğunuz hafta boyunca katıldığınız tüm WhatsApp sohbetlerinin bir listesini talep edin.
- 3Mesajlaşma modellerini analiz edinMesajlaşma hacminizi ve günlük ritimlerinizi görselleştirmek için çevrimdışı bir HTML paneli oluşturun.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
WhatsApp Chat Reader MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleWhatsApp Chat Reader MCP'yi Claude Code içine yükleyin
$ claude mcp add wa-chat-reader -- uvx wa-chat-readerWhatsApp Chat Reader MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}WhatsApp Chat Reader MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"wa-chat-reader": {
"type": "stdio",
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}WhatsApp Chat Reader MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"wa-chat-reader","type":"stdio","command":"uvx","args":["wa-chat-reader"]}'WhatsApp Chat Reader MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}WhatsApp Chat Reader MCP'yi Codex içine yükleyin
$ codex mcp add wa-chat-reader -- uvx wa-chat-readerWhatsApp Chat Reader MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.wa-chat-reader] command = "uvx" args = ["wa-chat-reader"]
WhatsApp Chat Reader MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user wa-chat-reader uvx -- wa-chat-readerWhatsApp Chat Reader MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}WhatsApp Chat Reader MCP araçları 2
README dosyasından algılandıget_whatsapp_messagesget_whatsapp_chat_list
| get_whatsapp_messages | — | |
| get_whatsapp_chat_list | — |
Yapılandırma
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.
| Ad | Açıklama | Sunucu |
|---|---|---|
| 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. |
Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirnabheetcloud/wa-chat-reader is public and reachablegithub.com/nabheetcloud/wa-chat-reader ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyorwa-chat-reader names nabheetcloud/wa-chat-reader as sourcepypi.org/project/wa-chat-reader/ ↗Geçti
- Derleme kökeni (Sigstore onayı)No build attestation published for this releaseKontrol edilmedi
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-07-05github.com/nabheetcloud/wa-chat-reader ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from wa-chat-readerGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok29 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok2 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişNo tool named like delete, drop or execGeçti
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
wa-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 soruları
WhatsApp Chat Reader MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add wa-chat-reader -- uvx wa-chat-reader komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
WhatsApp Chat Reader MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
WhatsApp Chat Reader MCP hangi araçları sunar?
2 araç sunar; bunlar arasında get_whatsapp_messages, get_whatsapp_chat_list yer alır.
WhatsApp verilerim buluta gönderiliyor mu?
Hayır, her şey yerel olarak çalışır ve hiçbir veri bilgisayarınızdan dışarı çıkmaz.
Bu sunucu mesajlarımı değiştirebilir veya silebilir mi?
Hayır, sunucu salt okunur moddadır ve herhangi bir şeyi yazmayı, değiştirmeyi veya silmeyi engelleyen SQLite modunu kullanır.
Bunu kullanmak için macOS üzerinde hangi izinler gerekiyor?
WhatsApp veritabanı korumalı bir grup konteynerinde bulunduğu için işlem için Sistem Ayarlarınızda Tam Disk Erişimi (Full Disk Access) gereklidir.
AI mesajlarımı ne kadar geriye dönük okuyabilir?
Geriye dönük bakma penceresi, varsayılan olarak 30 gün olan WHATSAPP_MAX_DAYS değişkeni ile sınırlandırılmıştır.