WhatsApp Chat Reader MCP server
✓ VerifiedMemungkinkan AI client untuk merangkum, mencari, dan melakukan penalaran terhadap riwayat chat WhatsApp lokal dengan membaca database SQLite lokal.
Juga dikenal sebagai NabheetCloud/wa-chat-reader, wa-chat-reader
- Stars
- 1
- Tools
- 2
- Unduhan, 30 hari
- 132
- Versi terbaru
- 0.1.0
- Commit terakhir
- 5 Jul 2026
- Lisensi
- MIT
Apa itu WhatsApp Chat Reader MCP?
Memungkinkan AI client untuk merangkum, mencari, dan melakukan penalaran terhadap riwayat chat WhatsApp lokal dengan membaca database SQLite lokal. Server ini menyediakan 2 tool, seperti get_whatsapp_messages, get_whatsapp_chat_list.
Ringkasan dibuat dari README proyek
Tentang WhatsApp Chat Reader MCP server
Alat ini memungkinkan Anda untuk merangkum dan mencari percakapan WhatsApp pribadi langsung dari dalam AI client. Cara kerjanya adalah dengan membaca database ChatStorage.sqlite lokal yang digunakan oleh aplikasi WhatsApp desktop di macOS, Windows, atau Linux. Karena server berjalan sepenuhnya di mesin Anda tanpa kode jaringan, data pesan Anda tetap lokal dan hanya dibagikan dengan MCP client spesifik yang Anda pilih untuk digunakan.
Developer dapat menghubungkan server ini ke client seperti Claude Desktop atau Claude Code menggunakan Python dan uv. Server ini menyediakan dua tool spesifik: get_whatsapp_messages untuk mengambil teks dari chat pribadi atau grup, dan get_whatsapp_chat_list untuk melihat nama chat yang aktif. Untuk melindungi privasi dan performa, environment variable WHATSAPP_MAX_DAYS membatasi seberapa jauh AI dapat melihat ke belakang, dengan default jendela waktu 30 hari. Pengguna macOS harus memberikan Full Disk Access ke proses tersebut agar dapat mengakses container database yang terlindungi.
Apa yang bisa Anda lakukan dengannya
- 1Merangkum aktivitas grup terbaruMinta AI client Anda untuk memberikan ringkasan pesan dari chat grup tertentu selama beberapa hari terakhir.
- 2Mengidentifikasi percakapan aktifMinta daftar semua chat WhatsApp yang Anda ikuti selama minggu ini.
- 3Menganalisis pola pengiriman pesanHasilkan dashboard HTML offline untuk memvisualisasikan volume pesan dan ritme harian Anda.
Ditulis berdasarkan README proyek. Setiap use case diperiksa terhadap kutipan dari README tersebut.
Cara menginstal WhatsApp Chat Reader MCP
Format diverifikasi 10 Nov 2026Tambahkan ke CursorTambahkan ke GooseInstal WhatsApp Chat Reader MCP di Claude Code
$ claude mcp add wa-chat-reader -- uvx wa-chat-readerInstal WhatsApp Chat Reader MCP di Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}Instal WhatsApp Chat Reader MCP di VS Code
.vscode/mcp.json
{
"servers": {
"wa-chat-reader": {
"type": "stdio",
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}Instal WhatsApp Chat Reader MCP di VS Code CLI
$ code --add-mcp '{"name":"wa-chat-reader","type":"stdio","command":"uvx","args":["wa-chat-reader"]}'Instal WhatsApp Chat Reader MCP di Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}Instal WhatsApp Chat Reader MCP di Codex
$ codex mcp add wa-chat-reader -- uvx wa-chat-readerInstal WhatsApp Chat Reader MCP di Codex config.toml
~/.codex/config.toml
[mcp_servers.wa-chat-reader] command = "uvx" args = ["wa-chat-reader"]
Instal WhatsApp Chat Reader MCP di Gemini CLI
$ gemini mcp add -s user wa-chat-reader uvx -- wa-chat-readerInstal WhatsApp Chat Reader MCP di Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
]
}
}
}Tool WhatsApp Chat Reader MCP 2
Terdeteksi dari READMEget_whatsapp_messagesget_whatsapp_chat_list
| get_whatsapp_messages | — | |
| get_whatsapp_chat_list | — |
Konfigurasi
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.
| Nama | Deskripsi | Tipe |
|---|---|---|
| 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. |
Pengecekan otomatis
Berjalan 14 Nov 2026Laporan lengkap →Lolos checks otomatis kami. Ini bukan audit keamanan: baca kodenya dan berikan server akses paling terbatas yang dibutuhkannya. Cara kerja checks
- Source repository terhubung dan dapat dijangkaunabheetcloud/wa-chat-reader is public and reachablegithub.com/nabheetcloud/wa-chat-reader ↗Lolos
- Nama paket mencantumkan repositori ini sebagai sumbernyawa-chat-reader names nabheetcloud/wa-chat-reader as sourcepypi.org/project/wa-chat-reader/ ↗Lolos
- Provenance build (atestasi Sigstore)No build attestation published for this releaseTidak diperiksa
- Lisensi open source (OSI)MITspdx.org/licenses/MIT.html ↗Lolos
- Ada commit atau release dalam satu tahun terakhirLast commit or release 2026-07-05github.com/nabheetcloud/wa-chat-reader ↗Lolos
- OpenSSF ScorecardTidak diperiksa
- Nama package tidak mirip dengan package populerNo popular package one edit away from wa-chat-readerLolos
- Tidak ada advisory kritis pada paket atau dependensinya29 resolved dependencies checked; no critical advisoryosv.dev ↗Lolos
- Tidak ada instruksi tersembunyi untuk model2 tool descriptions and the README read; no override phrases, credential paths or hidden charactersLolos
- Tools yang bersifat destruktif telah diberi labelNo tool named like delete, drop or execLolos
- Endpoint remote merespons handshake MCPTidak diperiksa
README
Lihat di GitHubwa-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
Pertanyaan tentang WhatsApp Chat Reader MCP
Bagaimana cara menambahkan WhatsApp Chat Reader MCP ke Claude Code?
Jalankan claude mcp add wa-chat-reader -- uvx wa-chat-reader di terminal Anda. Tambahkan --scope user agar tersedia di semua proyek.
Bagaimana cara menambahkan WhatsApp Chat Reader MCP ke Cursor?
Buka ~/.cursor/mcp.json dan tambahkan server di bawah mcpServers, menggunakan config Cursor yang ditunjukkan di bagian instalasi di atas.
Tool apa yang disediakan WhatsApp Chat Reader MCP?
Server ini menyediakan 2 tool, termasuk get_whatsapp_messages, get_whatsapp_chat_list.
Apakah data WhatsApp saya dikirim ke cloud?
Tidak, semuanya berjalan secara lokal dan tidak ada data yang keluar dari komputer Anda.
Apakah server ini bisa mengubah atau menghapus pesan saya?
Tidak, server ini bersifat read-only dan menggunakan mode SQLite yang mencegah penulisan, modifikasi, atau penghapusan apa pun.
Izin apa yang diperlukan di macOS untuk menggunakan ini?
Proses ini memerlukan Full Disk Access di System Settings Anda karena database WhatsApp berada di dalam group container yang terlindungi.
Seberapa jauh AI dapat membaca pesan saya?
Rentang waktu pencarian dibatasi oleh variabel WHATSAPP_MAX_DAYS, yang secara default adalah 30 hari.