WhatsApp Chat Reader (Unofficial)

Name: WhatsApp Chat Reader (Unofficial)
Author: NabheetCloud

de NabheetCloudversión 0.1.0i★ –iSe ejecuta en tu computadora

Nombre en el registroio.github.NabheetCloud/wa-chat-reader

Instalar

Resumen

Descripción del creador (original en inglés)

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

Los tres pilares de PopNx MCP

Estos tres nunca se combinan en una sola puntuación: las opiniones, las mediciones y la popularidad son cosas distintas.

Opinión de usuariosiAún no hay reseñasLas reseñas se abrirán junto con las cuentas en una etapa posterior
Nuestras revisiones básicasi1 de 1 superadasRevisado con información pública; el código aún no se ha escaneado
UsoiAún sin medir★ –

Qué puedes hacer con él

Todavía no escribimos un resumen sencillo para este. Abajo están los datos que leímos del registro.

Conexión: Se ejecuta en tu computadora
Transporte: stdio
Categoría: Chat y correo

Instalación

Elige la app de IA que usas y copia la configuración.

Antes de instalar

Revisiones básicas: 1 de 1 superadas
Se ejecuta en tu computadora con los permisos de tu usuario (archivos, red, apps).
Debes completar tú: WHATSAPP_DB_PATHS, WHATSAPP_BACKUP_PATHS, WHATSAPP_MAX_DAYS, WHATSAPP_DEBUG, WHATSAPP_LOG_FILE

Necesitas

PyPIuv de Python instalado (para el comando uvx)

¿Qué app usas?

ClaudeClaude CodeCursorVS CodeChatGPT

Elige tu app arriba. La recordamos, así que la próxima vez el botón dirá “Instalar en …”.

Abre Claude Desktop → Settings → Developer → Edit Config y pega esto en claude_desktop_config.json

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

Ejecuta esto en tu terminal

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

Completa los valores vacíos antes de ejecutarlo.

Abrir en Cursor

O copia la configuración tú

Pégalo en .cursor/mcp.json de tu proyecto, o en ~/.cursor/mcp.json

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

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Abrir en VS Code

O copia la configuración tú

Pégalo en .vscode/mcp.json de tu proyecto

{
  "servers": {
    "wa-chat-reader": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "wa-chat-reader"
      ],
      "env": {
        "WHATSAPP_DB_PATHS": "your-value",
        "WHATSAPP_BACKUP_PATHS": "your-value",
        "WHATSAPP_MAX_DAYS": "your-value",
        "WHATSAPP_DEBUG": "your-value",
        "WHATSAPP_LOG_FILE": "your-value"
      }
    }
  }
}

Tu navegador te pide permiso para abrir la app; luego la app muestra la configuración y te pide confirmar. Los valores de las claves quedan vacíos para que los completes tú.

Este se ejecuta en tu computadora, y ChatGPT solo puede conectarse a servidores en internet. Elige otra app.

Tu elección se guarda en una cookie en este dispositivo; no necesitas cuenta.

Valores que debes completar

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

Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.

Qué puede hacer

Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.

Revisiones básicasi

Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 6 nov 2026

✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub NabheetCloud, dueña del repo
… Aún sin revisar
Sigue en mantenimiento
Todavía no hemos leído este repo en GitHub
… Aún sin revisar
Tiene licencia
Todavía no hemos leído este repo en GitHub
– No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
– No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
… Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet

Comparado con otros en Chat y correoi

Más estrellas que el 0% de los otros 1763 servidores de esta categoría
Publicado en el registro más recientemente que el 15% de los otros 1763 servidores de esta categoría
Revisiones básicas iguales o mejores que el 100% de los otros 1763 servidores de esta categoría

Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.

Preguntas frecuentes

¿Es seguro WhatsApp Chat Reader (Unofficial)?

Superó 1 de 1 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.

¿Qué claves o códigos necesita?

El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.

¿Se ejecuta en mi computadora o en la nube?

Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).

¿Sigue en mantenimiento?

El repo de GitHub cambió por última vez –, y la última versión (0.1.0) llegó al registro hace 4 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Python (uv) en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: Vexa, emailmd, MCP WhatsApp Cloud

Alternativas

Servidores de la misma categoría hechos por otros creadores, ordenados por estrellas.

Cómo leer una tarjeta:★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi

Vexa

de Vexa-ai

Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.

Se ejecuta en la nube★ 2949Apache-2.0Actualizado hace 2 meses

Instalar

emailmd

de anypost

Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.

Computadora o nube★ 1385MITActualizado hace 30 días

Instalar

MCP WhatsApp Cloud

de codespar

MCP server for WhatsApp Cloud API (Meta) — messages, media, and templates via Graph API

Se ejecuta en tu computadora★ 277MITActualizado hace 5 meses

Instalar

README del creador

Abrir el README

Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.

wa-chat-reader

Unofficial, read-only [MCP](https://modelcontextprotocol.io) server for your local WhatsApp chat history.

wa-chat-reader reads the WhatsApp ChatStorage.sqlite database that the WhatsApp desktop app keeps on your machine and exposes two tools to any MCP client (Claude Code, Claude Desktop, etc.) so you can summarize, search, and reason over your own messages. Everything runs locally — no data ever leaves your computer.

⚠️ Not affiliated with, endorsed by, or connected to WhatsApp or Meta.

"WhatsApp" is a trademark of Meta Platforms, Inc. This is an independent,

unofficial tool that only reads a database WhatsApp already stores on your device.

Privacy & security

This tool touches highly sensitive data — your private conversations. Read this first.

Read-only. The database is opened with SQLite mode=ro&immutable=1; the server never writes to, modifies, or deletes anything.
Local-only. There is no network code. Messages are returned to your MCP client and nowhere else. Whatever LLM/client you connect will, of course, see the message text you ask it to read — you control that by choosing which client to run.
Your consent, your data. Only run this against your own device and your own chats. Do not use it to access anyone else's messages.
macOS access. The WhatsApp database lives in a protected group container. The process running this server needs Full Disk Access (System Settings → Privacy & Security → Full Disk Access), or point WHATSAPP_DB_PATHS at a readable copy you export yourself.
Scope control. WHATSAPP_MAX_DAYS (default 30) caps how far back any single call can read.

Install

Requires Python ≥ 3.10. Recommended: uv so the server runs in an isolated environment.

# one-shot run (no install)

uvx wa-chat-reader

or install with pip

pip install wa-chat-reader wa-chat-reader

Use in Claude Code

claude mcp add wa-chat-reader -- uvx wa-chat-reader

Or install as a plugin (see the marketplace section below), then ask Claude things like:

"Summarize my unread WhatsApp group chats from the last 3 days."
"List the WhatsApp chats I've been active in this week."

Configuration

All configuration is via environment variables (all optional):

Variable	Default	Description
`WHATSAPP_DB_PATHS`	platform default	`;`-separated candidate paths to `ChatStorage.sqlite` (first readable wins)
`WHATSAPP_BACKUP_PATHS`	—	`;`-separated fallback paths, tried after the primary paths
`WHATSAPP_MAX_DAYS`	`30`	Max look-back window (days) a caller may request
`WHATSAPP_DEBUG`	`false`	`true` for verbose logging to stderr
`WHATSAPP_LOG_FILE`	—	Optional path to also write logs to a file

Default database locations:

OS	Path
macOS	`~/Library/Group Containers/group.net.whatsapp.WhatsApp.shared/ChatStorage.sqlite`
Windows	`~/AppData/Roaming/WhatsApp/Databases/ChatStorage.sqlite`
Linux	`~/.local/share/whatsapp/ChatStorage.sqlite`

Tools

Tool	Description
`get_whatsapp_messages`	Concatenated message text from group and personal chats within a look-back window. Params: `days` (1–max), `chat_type` (`all`/`groups`/`personal`). Read-only.
`get_whatsapp_chat_list`	Active chat names (no message bodies) within a look-back window. Param: `days`. Read-only.

Both tools are annotated readOnlyHint: true.

Bonus: activity dashboard

whatsapp_dashboard.py renders a self-contained, offline HTML dashboard of your messaging activity (volume over time, daily/weekly rhythm, top chats) straight from the same database:

python3 whatsapp_dashboard.py            # -> whatsapp_dashboard.html

The generated HTML contains real contact names — it is git-ignored and meant to stay local.

Develop

git clone https://github.com/NabheetCloud/wa-chat-reader

cd wa-chat-reader pip install -e . python3 simple_whatsapp_mcp.py # run from source without installing

WhatsApp Chat Reader (Unofficial)

Resumen

Los tres pilares de PopNx MCP

Qué puedes hacer con él

Instalación

Antes de instalar

Valores que debes completar

Qué puede hacer

Revisiones básicasi

El creador coincide con el repo

Sigue en mantenimiento

Tiene licencia

El endpoint responde

Inicio de sesión con OAuth

Sin instrucciones ocultas en las descripciones de herramientas

Comparado con otros en Chat y correoi

Preguntas frecuentes

Alternativas

Vexa

emailmd

MCP WhatsApp Cloud

README del creador

wa-chat-reader

Privacy & security

Install

or install with pip

Use in Claude Code

Configuration

Tools

Bonus: activity dashboard

Develop

License