WhatsApp Chat Reader (Unofficial)

Indexed by io.github.NabheetCloud

About

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

Use this server

Add it to your MCP client. The catalogue lists this config verbatim from its source — it does not run, download, or vouch for the server. Review the command before you run it.

Transportstdio (runs a local command)

Env varsWHATSAPP_DB_PATHS WHATSAPP_BACKUP_PATHS WHATSAPP_MAX_DAYS WHATSAPP_DEBUG WHATSAPP_LOG_FILE

Claude Code

claude mcp add --env WHATSAPP_DB_PATHS= --env WHATSAPP_BACKUP_PATHS= --env WHATSAPP_MAX_DAYS= --env WHATSAPP_DEBUG= --env WHATSAPP_LOG_FILE= wa-chat-reader -- uvx wa-chat-reader

Cursor

Add to Cursor

If the button doesn't open Cursor, use the JSON below — Cursor accepts the same mcpServers config.

VS Code

code --add-mcp '{"name":"wa-chat-reader","command":"uvx","args":["wa-chat-reader"],"env":{"WHATSAPP_DB_PATHS":"","WHATSAPP_BACKUP_PATHS":"","WHATSAPP_MAX_DAYS":"","WHATSAPP_DEBUG":"","WHATSAPP_LOG_FILE":""}}'

JSON

{
  "mcpServers": {
    "wa-chat-reader": {
      "command": "uvx",
      "args": [
        "wa-chat-reader"
      ],
      "env": {
        "WHATSAPP_DB_PATHS": "",
        "WHATSAPP_BACKUP_PATHS": "",
        "WHATSAPP_MAX_DAYS": "",
        "WHATSAPP_DEBUG": "",
        "WHATSAPP_LOG_FILE": ""
      }
    }
  }
}

Environment variables are listed by name only — fill in your own values. Entries never carry secrets.