Unofficial read-only MCP server for your local WhatsApp chat history (stays on your machine).
Connect Runs on your machine
claude mcp add wa-chat-reader -e WHATSAPP_DB_PATHS=<WHATSAPP_DB_PATHS> -e WHATSAPP_BACKUP_PATHS=<WHATSAPP_BACKUP_PATHS> -e WHATSAPP_MAX_DAYS=<WHATSAPP_MAX_DAYS> -e WHATSAPP_DEBUG=<WHATSAPP_DEBUG> -e WHATSAPP_LOG_FILE=<WHATSAPP_LOG_FILE> -- uvx wa-chat-reader==0.1.0{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader==0.1.0"
],
"env": {
"WHATSAPP_DB_PATHS": "<WHATSAPP_DB_PATHS>",
"WHATSAPP_BACKUP_PATHS": "<WHATSAPP_BACKUP_PATHS>",
"WHATSAPP_MAX_DAYS": "<WHATSAPP_MAX_DAYS>",
"WHATSAPP_DEBUG": "<WHATSAPP_DEBUG>",
"WHATSAPP_LOG_FILE": "<WHATSAPP_LOG_FILE>"
}
}
}
}{
"mcpServers": {
"wa-chat-reader": {
"command": "uvx",
"args": [
"wa-chat-reader==0.1.0"
],
"env": {
"WHATSAPP_DB_PATHS": "<WHATSAPP_DB_PATHS>",
"WHATSAPP_BACKUP_PATHS": "<WHATSAPP_BACKUP_PATHS>",
"WHATSAPP_MAX_DAYS": "<WHATSAPP_MAX_DAYS>",
"WHATSAPP_DEBUG": "<WHATSAPP_DEBUG>",
"WHATSAPP_LOG_FILE": "<WHATSAPP_LOG_FILE>"
}
}
}
}{
"servers": {
"wa-chat-reader": {
"type": "stdio",
"command": "uvx",
"args": [
"wa-chat-reader==0.1.0"
],
"env": {
"WHATSAPP_DB_PATHS": "<WHATSAPP_DB_PATHS>",
"WHATSAPP_BACKUP_PATHS": "<WHATSAPP_BACKUP_PATHS>",
"WHATSAPP_MAX_DAYS": "<WHATSAPP_MAX_DAYS>",
"WHATSAPP_DEBUG": "<WHATSAPP_DEBUG>",
"WHATSAPP_LOG_FILE": "<WHATSAPP_LOG_FILE>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
WHATSAPP_DB_PATHSOptional | Semicolon-separated paths to ChatStorage.sqlite. If unset, a platform default is used. |
WHATSAPP_BACKUP_PATHSOptional | Semicolon-separated fallback database paths, tried after the primary paths. |
WHATSAPP_MAX_DAYSOptional | Maximum look-back window in days a caller may request. |
WHATSAPP_DEBUGOptional | Set to 'true' for verbose logging to stderr. |
WHATSAPP_LOG_FILEOptional | Optional path to also write logs to a file. |
Details
| Package | [email protected] (PYPI, stdio) |
| First published | 5 Jul 2026 |
| Last updated | 5 Jul 2026 |
| Registry name | io.github.NabheetCloud/wa-chat-reader |
More communication servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.