WhatsApp Chat Reader (Unofficial) MCP Server

io.github.NabheetCloud/wa-chat-reader

Repository Registry

What is the WhatsApp Chat Reader (Unofficial) MCP server?

Unofficial read-only MCP server for your local WhatsApp chat history (stays on your machine).

How to install WhatsApp Chat Reader (Unofficial)

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

WHATSAPP_DB_PATHS
Semicolon-separated paths to ChatStorage.sqlite. If unset, a platform default is used.
WHATSAPP_BACKUP_PATHS
Semicolon-separated fallback database paths, tried after the primary paths.
WHATSAPP_MAX_DAYS
Maximum look-back window in days a caller may request.
WHATSAPP_DEBUG
Set to 'true' for verbose logging to stderr.
WHATSAPP_LOG_FILE
Optional path to also write logs to a file.

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "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>"
      }
    }
  }
}