Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.
PopNx MCPServidores MCP para quienes usan IA · explicados con palabras sencillas
☰ MenúEspañol Ajustes
Modo principiante Activado
ColoresSistemaClaroOscuro
IdiomaไทยEnglish中文日本語한국어EspañolDeutsch

WhatsApp Chat Reader (Unofficial)

de NabheetCloudversión 0.1.0i★ 1iSe ejecuta en tu computadora
Nombre en el registroio.github.NabheetCloud/wa-chat-reader

Cómo instalar

What it does

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

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed
  • Category Chat y correo

Instalación

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

Pasó 3/3 revisiones · Funciona en tu computadora

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

Necesitas una clave de WhatsApp Chat Reader (Unofficial) (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

  1. Instala Python (uv)

    Una sola vez; sirve para todos los servidores que necesitan Python (uv)

    Abrir la página de descarga de Python (uv) ↗

  2. Regístrate y crea una clave de WhatsApp Chat Reader (Unofficial)

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  4. Pega esta configuración y guarda el archivo

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

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Cierra Claude y vuelve a abrirlo

  6. Pruébalo

    Usa WhatsApp Chat Reader (Unofficial) y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando WhatsApp Chat Reader (Unofficial) o muestra una herramienta de WhatsApp Chat Reader (Unofficial) en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

ChatGPT todavía no puede conectar WhatsApp Chat Reader (Unofficial)

WhatsApp Chat Reader (Unofficial) se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar WhatsApp Chat Reader (Unofficial)

  • Necesitas una clave de WhatsApp Chat Reader (Unofficial) (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
  • Necesitas una clave de WhatsApp Chat Reader (Unofficial) (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
  • Necesitas una clave de WhatsApp Chat Reader (Unofficial) (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)
  • Necesitas una clave de WhatsApp Chat Reader (Unofficial) (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

B · Otros en Chat y correo que funcionan con ChatGPT

Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave

Funciona con Claude Code, pero hay que preparar algo antes

Necesitas una clave de WhatsApp Chat Reader (Unofficial) (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

  1. Instala Python (uv)

    Una sola vez; sirve para todos los servidores que necesitan Python (uv)

    Abrir la página de descarga de Python (uv) ↗

  2. Regístrate y crea una clave de WhatsApp Chat Reader (Unofficial)

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  4. Pega este comando y pulsa Enter

    claude mcp add --scope user 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

    Cambia “your-value” por tu clave antes de pulsar Enter

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Escribe /mcp en Claude Code

    Deberías ver WhatsApp Chat Reader (Unofficial) en la lista como conectado

  6. Pruébalo

    Usa WhatsApp Chat Reader (Unofficial) y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando WhatsApp Chat Reader (Unofficial) o muestra una herramienta de WhatsApp Chat Reader (Unofficial) en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con Cursor, pero hay que preparar algo antes

Necesitas una clave de WhatsApp Chat Reader (Unofficial) (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

  1. Instala Python (uv)

    Una sola vez; sirve para todos los servidores que necesitan Python (uv)

    Abrir la página de descarga de Python (uv) ↗

  2. Regístrate y crea una clave de WhatsApp Chat Reader (Unofficial)

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  4. Escribe tu clave

    En la configuración de WhatsApp Chat Reader (Unofficial), WHATSAPP_DB_PATHS, WHATSAPP_BACKUP_PATHS, WHATSAPP_MAX_DAYS, WHATSAPP_DEBUG, WHATSAPP_LOG_FILE está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Abre el chat de IA de Cursor en modo Agent

  6. Pruébalo

    Usa WhatsApp Chat Reader (Unofficial) y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando WhatsApp Chat Reader (Unofficial) o muestra una herramienta de WhatsApp Chat Reader (Unofficial) en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Funciona con VS Code, pero hay que preparar algo antes

Necesitas una clave de WhatsApp Chat Reader (Unofficial) (créala en el sitio del autor) · Instala Python (uv) en tu computadora primero (una sola vez)

  1. Instala Python (uv)

    Una sola vez; sirve para todos los servidores que necesitan Python (uv)

    Abrir la página de descarga de Python (uv) ↗

  2. Regístrate y crea una clave de WhatsApp Chat Reader (Unofficial)

    Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.

    Cómo obtener la clave está en el README del autor, más abajo

  3. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  4. Escribe tu clave

    En la configuración de WhatsApp Chat Reader (Unofficial), WHATSAPP_DB_PATHS, WHATSAPP_BACKUP_PATHS, WHATSAPP_MAX_DAYS, WHATSAPP_DEBUG, WHATSAPP_LOG_FILE está vacío; añade tu clave y guarda

    Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie

  5. Abre el chat de IA de VS Code en modo Agent

  6. Pruébalo

    Usa WhatsApp Chat Reader (Unofficial) y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando WhatsApp Chat Reader (Unofficial) o muestra una herramienta de WhatsApp Chat Reader (Unofficial) en la respuesta, ya está conectado

Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión

Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps

Ver todas las apps que usan MCP →

La configuración JSON está en “Para desarrolladores”, abajo

¿Te atascaste? Pregunta a quien usa WhatsApp Chat Reader (Unofficial)💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user 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

Claude Desktop (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"
      }
    }
  }
}

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

VS Code (mcp.json)

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

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.

De un vistazo

Descargas por semanai
34/sem
Conexión
Se ejecuta en tu computadora
Última versióni
0.1.0
Categoríai
Chat y correo
Publicado en el registroi
5 jul 2026
Último cambio de códigoi
5 jul 2026
Creador
NabheetCloud
Paquetes
pypi: wa-chat-reader
Estado en el registro
Activo

Qué apps pueden usarlo

Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.

Se ejecutan en tu computadora en

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

Todas las apps, con ventajas y desventajas →

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 12 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

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 4 meses

  • ✓ Superada

    Tiene licencia

    Usa MIT

  • – 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

Conversación

Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.

Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.

Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.

Inicia sesión con Google para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión con Google para escribir una reseña

Comparado con otros en Chat y correoi

  • Más estrellas que el 83% de los otros 1964 servidores de esta categoría
  • Publicado en el registro más recientemente que el 14% de los otros 1964 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 100% de los otros 1964 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ó 3 de 3 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 hace 4 meses, 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: Inbox Zero, draw.io, TradingMCP

Otros de la misma categoría

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

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

Inbox Zero

Search Gmail and Outlook, save drafts, manage email rules, and view email stats.

de elie222Muy usado★ 13 milActualizado hace 42 días

Se ejecuta en la nube
Instalar

draw.io

Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.

de jgraphMuy usado★ 5,8 milActualizado anteayer

Se ejecuta en la nube✓ del servicio · draw.io
Instalar

TradingMCP

Market analysis for AI assistants: screeners, multi-timeframe analysis, backtests, in-chat charts.

de atilaahmettanerMuy usado★ 5,3 milActualizado hace 21 días

Se ejecuta en la nube
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):

VariableDefaultDescription
WHATSAPP_DB_PATHSplatform default;-separated candidate paths to ChatStorage.sqlite (first readable wins)
WHATSAPP_BACKUP_PATHS—;-separated fallback paths, tried after the primary paths
WHATSAPP_MAX_DAYS30Max look-back window (days) a caller may request
WHATSAPP_DEBUGfalsetrue for verbose logging to stderr
WHATSAPP_LOG_FILE—Optional path to also write logs to a file

Default database locations:

OSPath
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

ToolDescription
get_whatsapp_messagesConcatenated 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_listActive 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

License

MIT © 2026 Nabheet Madan