Server data from the Official MCP Registry
Unofficial read-only MCP server for your local WhatsApp chat history (stays on your machine).
Unofficial read-only MCP server for your local WhatsApp chat history (stays on your machine).
wa-chat-reader is a well-designed read-only MCP server for accessing local WhatsApp chat history. The codebase demonstrates strong security practices: database is opened in read-only immutable mode, no network exfiltration, proper environment variable configuration, and explicit privacy disclosures. Minor issues include broad exception handling in the tool handler and lack of input sanitization for the `days` parameter, but these do not create practical vulnerabilities given the server's constrained purpose. Supply chain analysis found 3 known vulnerabilities in dependencies (0 critical, 3 high severity). Package verification found 1 issue.
7 files analyzed · 8 issues found
Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.
This plugin requests these system permissions. Most are normal for its category.
Set these up before or after installing:
Environment variable: WHATSAPP_DB_PATHS
Environment variable: WHATSAPP_BACKUP_PATHS
Environment variable: WHATSAPP_MAX_DAYS
Environment variable: WHATSAPP_DEBUG
Environment variable: WHATSAPP_LOG_FILE
Add this to your MCP configuration file:
{
"mcpServers": {
"io-github-nabheetcloud-wa-chat-reader": {
"env": {
"WHATSAPP_DEBUG": "your-whatsapp-debug-here",
"WHATSAPP_DB_PATHS": "your-whatsapp-db-paths-here",
"WHATSAPP_LOG_FILE": "your-whatsapp-log-file-here",
"WHATSAPP_MAX_DAYS": "your-whatsapp-max-days-here",
"WHATSAPP_BACKUP_PATHS": "your-whatsapp-backup-paths-here"
},
"args": [
"wa-chat-reader"
],
"command": "uvx"
}
}
}From the project's GitHub README.
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.
This tool touches highly sensitive data — your private conversations. Read this first.
mode=ro&immutable=1; the server
never writes to, modifies, or deletes anything.WHATSAPP_DB_PATHS at a readable copy you export yourself.WHATSAPP_MAX_DAYS (default 30) caps how far back any single
call can read.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
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:
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 |
| 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.
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.
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
MIT © 2026 Nabheet Madan
Be the first to review this server!
by Modelcontextprotocol · Developer Tools
Web content fetching and conversion for efficient LLM usage
by Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
by Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.