WhatsApp Chat Reader (Unofficial) MCP Server

Name: WhatsApp Chat Reader (Unofficial) MCP Server
Author: io.github.NabheetCloud

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.

Claude Desktop

~/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>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.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>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_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>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

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

Claude Code

claude mcp add wa-chat-reader --env WHATSAPP_DB_PATHS=<YOUR_WHATSAPP_DB_PATHS> --env WHATSAPP_BACKUP_PATHS=<YOUR_WHATSAPP_BACKUP_PATHS> --env WHATSAPP_MAX_DAYS=<YOUR_WHATSAPP_MAX_DAYS> --env WHATSAPP_DEBUG=<YOUR_WHATSAPP_DEBUG> --env WHATSAPP_LOG_FILE=<YOUR_WHATSAPP_LOG_FILE> -- uvx wa-chat-reader