WhatsApp Chat Reader (Unofficial)
Rank #69,403io.github.NabheetCloud/wa-chat-reader
Unofficial read-only MCP server for your local WhatsApp chat history (stays on your machine).
WhatsApp Chat Reader (Unofficial) is a Model Context Protocol (MCP) server published by nabheetcloud. It ranks #69,403 of 137,138 servers tracked on MCP Toplist, and its repository has 1 GitHub stars. WhatsApp Chat Reader (Unofficial) is listed across 3 registries — Official MCP, PulseMCP and Glama, with 1 tracked version. It was first listed on Jul 5, 2026 and most recently updated on Jul 5, 2026.
Ranks ahead of 67,735 of 137,138 servers on MCP Toplist.
Use WhatsApp Chat Reader (Unofficial)
No credentials or required configuration declared — add it to your MCP client and go.
claude mcp add wa-chat-reader -e "WHATSAPP_DB_PATHS=<your WHATSAPP_DB_PATHS>" -e "WHATSAPP_BACKUP_PATHS=<your WHATSAPP_BACKUP_PATHS>" -e "WHATSAPP_MAX_DAYS=<your WHATSAPP_MAX_DAYS>" -e "WHATSAPP_DEBUG=<your WHATSAPP_DEBUG>" -e "WHATSAPP_LOG_FILE=<your WHATSAPP_LOG_FILE>" -- uvx wa-chat-readerReplace each placeholder with your own value before saving.
[mcp_servers.wa-chat-reader]
command = "uvx"
args = ["wa-chat-reader"]
[mcp_servers.wa-chat-reader.env]
WHATSAPP_DB_PATHS = "<your WHATSAPP_DB_PATHS>"
WHATSAPP_BACKUP_PATHS = "<your WHATSAPP_BACKUP_PATHS>"
WHATSAPP_MAX_DAYS = "<your WHATSAPP_MAX_DAYS>"
WHATSAPP_DEBUG = "<your WHATSAPP_DEBUG>"
WHATSAPP_LOG_FILE = "<your WHATSAPP_LOG_FILE>"Add to ~/.codex/config.toml. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
],
"env": {
"WHATSAPP_DB_PATHS": "<your WHATSAPP_DB_PATHS>",
"WHATSAPP_BACKUP_PATHS": "<your WHATSAPP_BACKUP_PATHS>",
"WHATSAPP_MAX_DAYS": "<your WHATSAPP_MAX_DAYS>",
"WHATSAPP_DEBUG": "<your WHATSAPP_DEBUG>",
"WHATSAPP_LOG_FILE": "<your WHATSAPP_LOG_FILE>"
}
}
}
}Add to claude_desktop_config.json (Settings → Developer → Edit Config). Replace each placeholder with your own value before saving.
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
],
"env": {
"WHATSAPP_DB_PATHS": "<your WHATSAPP_DB_PATHS>",
"WHATSAPP_BACKUP_PATHS": "<your WHATSAPP_BACKUP_PATHS>",
"WHATSAPP_MAX_DAYS": "<your WHATSAPP_MAX_DAYS>",
"WHATSAPP_DEBUG": "<your WHATSAPP_DEBUG>",
"WHATSAPP_LOG_FILE": "<your WHATSAPP_LOG_FILE>"
}
}
}
}Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (per project). Replace each placeholder with your own value before saving.
{
"servers": {
"wa-chat-reader": {
"type": "stdio",
"command": "uvx",
"args": [
"wa-chat-reader"
],
"env": {
"WHATSAPP_DB_PATHS": "<your WHATSAPP_DB_PATHS>",
"WHATSAPP_BACKUP_PATHS": "<your WHATSAPP_BACKUP_PATHS>",
"WHATSAPP_MAX_DAYS": "<your WHATSAPP_MAX_DAYS>",
"WHATSAPP_DEBUG": "<your WHATSAPP_DEBUG>",
"WHATSAPP_LOG_FILE": "<your WHATSAPP_LOG_FILE>"
}
}
}
}Save as .vscode/mcp.json in your workspace. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
],
"env": {
"WHATSAPP_DB_PATHS": "<your WHATSAPP_DB_PATHS>",
"WHATSAPP_BACKUP_PATHS": "<your WHATSAPP_BACKUP_PATHS>",
"WHATSAPP_MAX_DAYS": "<your WHATSAPP_MAX_DAYS>",
"WHATSAPP_DEBUG": "<your WHATSAPP_DEBUG>",
"WHATSAPP_LOG_FILE": "<your WHATSAPP_LOG_FILE>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json. Replace each placeholder with your own value before saving.
{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader"
],
"env": {
"WHATSAPP_DB_PATHS": "<your WHATSAPP_DB_PATHS>",
"WHATSAPP_BACKUP_PATHS": "<your WHATSAPP_BACKUP_PATHS>",
"WHATSAPP_MAX_DAYS": "<your WHATSAPP_MAX_DAYS>",
"WHATSAPP_DEBUG": "<your WHATSAPP_DEBUG>",
"WHATSAPP_LOG_FILE": "<your WHATSAPP_LOG_FILE>"
}
}
}
}Replace each placeholder with your own value before saving.
Show your rank
Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.
[](https://mcptoplist.com/server/io.github.NabheetCloud%2Fwa-chat-reader)<a href="https://mcptoplist.com/server/io.github.NabheetCloud%2Fwa-chat-reader"><img src="https://mcptoplist.com/badge/io.github.NabheetCloud%2Fwa-chat-reader.svg" alt="MCP Toplist: #69,403 of 137,138" /></a>Variants: append ?metric=score or ?metric=stars to the image URL.
Listed on 3 registries
nabheetcloud
Available versions (1)
| Version | Published |
|---|---|
| 0.1.0 | Jul 5, 2026 |
Frequently asked questions
- Who maintains WhatsApp Chat Reader (Unofficial)?
- WhatsApp Chat Reader (Unofficial) is maintained by nabheetcloud, which publishes 1 MCP server (1 total version) tracked on MCP Toplist.
- Is WhatsApp Chat Reader (Unofficial) listed on the Official MCP Registry?
- Yes — WhatsApp Chat Reader (Unofficial) is listed on the Official MCP Registry, alongside PulseMCP and Glama.
- How many versions does WhatsApp Chat Reader (Unofficial) have?
- MCP Toplist tracks 1 version of WhatsApp Chat Reader (Unofficial), most recently published on Jul 5, 2026.
- Where can I find the source code for WhatsApp Chat Reader (Unofficial)?
- The source code for WhatsApp Chat Reader (Unofficial) is hosted at github.com/nabheetcloud/wa-chat-reader.
Do you run this server?
Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.