Skip to content
VS Code

WhatsApp Chat Reader (Unofficial) for VS Code

io.github.nabheetcloud/wa-chat-reader

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

client:VS Code transport:stdio runtime:pypi

Install WhatsApp Chat Reader (Unofficial) in VS Code

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "whatsapp-db-paths",
      "description": "WHATSAPP_DB_PATHS",
      "password": true
    },
    {
      "type": "promptString",
      "id": "whatsapp-backup-paths",
      "description": "WHATSAPP_BACKUP_PATHS",
      "password": true
    },
    {
      "type": "promptString",
      "id": "whatsapp-max-days",
      "description": "WHATSAPP_MAX_DAYS",
      "password": true
    },
    {
      "type": "promptString",
      "id": "whatsapp-debug",
      "description": "WHATSAPP_DEBUG",
      "password": true
    },
    {
      "type": "promptString",
      "id": "whatsapp-log-file",
      "description": "WHATSAPP_LOG_FILE",
      "password": true
    }
  ],
  "servers": {
    "wa-chat-reader": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "wa-chat-reader"
      ],
      "env": {
        "WHATSAPP_DB_PATHS": "${input:whatsapp-db-paths}",
        "WHATSAPP_BACKUP_PATHS": "${input:whatsapp-backup-paths}",
        "WHATSAPP_MAX_DAYS": "${input:whatsapp-max-days}",
        "WHATSAPP_DEBUG": "${input:whatsapp-debug}",
        "WHATSAPP_LOG_FILE": "${input:whatsapp-log-file}"
      }
    }
  }
}

VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs

WhatsApp Chat Reader (Unofficial) in other clients