Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

WhatsApp Web MCP Server

de mario-andreschakversión 1.2.0i★ 31iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.mario-andreschak/mcp-whatsapp-web

Cómo instalar

What it does

WhatsApp MCP via web.js or browserless Baileys: messages, media, chats, groups and contacts

  • Connects Se ejecuta en tu computadora
  • Account or key No key needed · 1 setting to fill in (BROWSER_EXECUTABLE_PATH)
  • Category Chat y correo

Por qué está en este puesto

Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes

Popularidad18/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso30/100

Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)

Instalación

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

Que tu IA lo instale con una frase

Instala WhatsApp Web MCP Server. Sigue https://mcp.popnx.com/i/mario-andreschak-mcp-whatsapp-web.md, enséñame los comandos y espera mi OK antes de ejecutarlos.

Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA

Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026

Primero: ¿qué IA usas?

Elige tu app y los pasos aparecen abajo.

Funciona con Claude, pero hay que preparar algo antes

1 ajuste(s) que rellenar (BROWSER_EXECUTABLE_PATH) · Instala Node.js 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

Que la IA lo instale

Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server WhatsApp Web MCP Server para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "whatsapp-web": { "command": "npx", "args": [ "-y", "mcp-whatsapp-web" ], "env": { "BROWSER_EXECUTABLE_PATH": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En BROWSER_EXECUTABLE_PATH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de WhatsApp Web MCP Server aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • BROWSER_EXECUTABLE_PATH Solo webjs: ejecutable del navegador. Chrome y Edge se detectan automáticamente; configúralo para usar un navegador específico. Chrome/Edge es necesario para enviar vídeos y GIF.
      Ver original en ingléswebjs only: browser executable. Chrome and Edge are auto-detected; set this to use a specific browser. Chrome/Edge is required for sending videos and GIFs.

    Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

  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": {
        "whatsapp-web": {
          "command": "npx",
          "args": [
            "-y",
            "mcp-whatsapp-web"
          ],
          "env": {
            "BROWSER_EXECUTABLE_PATH": "your-value"
          }
        }
      }
    }
  5. Cierra Claude y vuelve a abrirlo

  6. Pruébalo

    Usa WhatsApp Web MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude dice que está usando WhatsApp Web MCP Server o muestra una herramienta de WhatsApp Web MCP Server en la respuesta, ya está conectado

15 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • WHATSAPP_BACKEND Backend de WhatsApp: webjs usa un perfil de navegador persistente; baileys se conecta sin navegador y requiere un emparejamiento separado.
    Ver original en inglésWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
    · valor por defecto webjs
  • BAILEYS_SESSION_DIR Directorio de credenciales de Baileys y del historial sincronizado (predeterminado: /baileys-sessions). Usa una ruta absoluta privada, propiedad de un solo proceso del servidor.
    Ver original en inglésBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL Nivel de registro para el archivo de logs (logs/mcp-whatsapp.log).
    Ver original en inglésLog level for the log file (logs/mcp-whatsapp.log)
    · valor por defecto info
  • LOG_STDERR_LEVEL Nivel de registro para stderr (visible en la mayoría de los logs de clientes MCP).
    Ver original en inglésLog level for stderr (visible in most MCP client logs)
    · valor por defecto warn
  • WHATSAPP_HEADLESS Solo webjs: establezca false para mostrar la ventana del navegador en lugar de ejecutar sin interfaz
    Ver original en ingléswebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX Solo webjs: desactiva explícitamente el sandbox del navegador para contenedores que lo requieran. El sandbox está habilitado por defecto.
    Ver original en ingléswebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
    · valor por defecto false
  • WHATSAPP_SESSION_DIR Solo webjs: directorio persistente del perfil del navegador (predeterminado: /whatsapp-sessions)
    Ver original en ingléswebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER Emparejamiento por número de teléfono: si se define (formato internacional sin símbolos, p. ej. 4915112345678), se registra en stderr un código de emparejamiento de 8 caracteres al iniciar, en lugar de depender del código QR.
    Ver original en inglésPhone number pairing: when set (international, symbol-free format, e.g. 4915112345678), an 8-character pairing code is logged to stderr on startup instead of relying on the QR code
  • FFMPEG_PATH Ruta a un binario de ffmpeg (solo necesaria para reemplazar el ffmpeg instalado automáticamente mediante el paquete npm ffmpeg-static)
    Ver original en inglésPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION Solo webjs: fija la versión de WhatsApp Web si una actualización del lado de WhatsApp rompe el cliente.
    Ver original en ingléswebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS webjs only: connection health check interval in milliseconds (<=0 disables) · valor por defecto 60000
  • TOOL_READY_TIMEOUT_MS Tiempo que las llamadas a herramientas esperan a que el cliente de WhatsApp esté listo antes de devolver un error.
    Ver original en inglésHow long tool calls wait for the WhatsApp client to become ready before erroring
    · valor por defecto 45000
  • MCP_HTTP_PORT When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST Dirección de enlace para el endpoint HTTP (no lo expongas públicamente; el endpoint controla tu cuenta personal de WhatsApp)
    Ver original en inglésBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
    · valor por defecto 127.0.0.1
  • MCP_OAUTH Habilita OAuth para el endpoint HTTP: /mcp requiere un token bearer y los clientes se autentican mediante una página del navegador que muestra el código QR de WhatsApp o el formulario de emparejamiento
    Ver original en inglésEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

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 Web MCP Server

WhatsApp Web MCP Server 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 Web MCP Server

  • 1 ajuste(s) que rellenar (BROWSER_EXECUTABLE_PATH) · Instala Node.js 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 ajuste(s) que rellenar (BROWSER_EXECUTABLE_PATH) · Instala Node.js en tu computadora primero (una sola vez)
  • 1 ajuste(s) que rellenar (BROWSER_EXECUTABLE_PATH) · Instala Node.js en tu computadora primero (una sola vez)
  • 1 ajuste(s) que rellenar (BROWSER_EXECUTABLE_PATH) · Instala Node.js 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

1 ajuste(s) que rellenar (BROWSER_EXECUTABLE_PATH) · Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server WhatsApp Web MCP Server para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user whatsapp-web --env BROWSER_EXECUTABLE_PATH=your-value -- npx -y mcp-whatsapp-web 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En BROWSER_EXECUTABLE_PATH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de WhatsApp Web MCP Server aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • BROWSER_EXECUTABLE_PATH Solo webjs: ejecutable del navegador. Chrome y Edge se detectan automáticamente; configúralo para usar un navegador específico. Chrome/Edge es necesario para enviar vídeos y GIF.
      Ver original en ingléswebjs only: browser executable. Chrome and Edge are auto-detected; set this to use a specific browser. Chrome/Edge is required for sending videos and GIFs.

    Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

  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 whatsapp-web --env BROWSER_EXECUTABLE_PATH=your-value -- npx -y mcp-whatsapp-web
  5. Escribe /mcp en Claude Code

    Deberías ver WhatsApp Web MCP Server en la lista como conectado

  6. Pruébalo

    Usa WhatsApp Web MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Claude Code dice que está usando WhatsApp Web MCP Server o muestra una herramienta de WhatsApp Web MCP Server en la respuesta, ya está conectado

15 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • WHATSAPP_BACKEND Backend de WhatsApp: webjs usa un perfil de navegador persistente; baileys se conecta sin navegador y requiere un emparejamiento separado.
    Ver original en inglésWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
    · valor por defecto webjs
  • BAILEYS_SESSION_DIR Directorio de credenciales de Baileys y del historial sincronizado (predeterminado: /baileys-sessions). Usa una ruta absoluta privada, propiedad de un solo proceso del servidor.
    Ver original en inglésBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL Nivel de registro para el archivo de logs (logs/mcp-whatsapp.log).
    Ver original en inglésLog level for the log file (logs/mcp-whatsapp.log)
    · valor por defecto info
  • LOG_STDERR_LEVEL Nivel de registro para stderr (visible en la mayoría de los logs de clientes MCP).
    Ver original en inglésLog level for stderr (visible in most MCP client logs)
    · valor por defecto warn
  • WHATSAPP_HEADLESS Solo webjs: establezca false para mostrar la ventana del navegador en lugar de ejecutar sin interfaz
    Ver original en ingléswebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX Solo webjs: desactiva explícitamente el sandbox del navegador para contenedores que lo requieran. El sandbox está habilitado por defecto.
    Ver original en ingléswebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
    · valor por defecto false
  • WHATSAPP_SESSION_DIR Solo webjs: directorio persistente del perfil del navegador (predeterminado: /whatsapp-sessions)
    Ver original en ingléswebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER Emparejamiento por número de teléfono: si se define (formato internacional sin símbolos, p. ej. 4915112345678), se registra en stderr un código de emparejamiento de 8 caracteres al iniciar, en lugar de depender del código QR.
    Ver original en inglésPhone number pairing: when set (international, symbol-free format, e.g. 4915112345678), an 8-character pairing code is logged to stderr on startup instead of relying on the QR code
  • FFMPEG_PATH Ruta a un binario de ffmpeg (solo necesaria para reemplazar el ffmpeg instalado automáticamente mediante el paquete npm ffmpeg-static)
    Ver original en inglésPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION Solo webjs: fija la versión de WhatsApp Web si una actualización del lado de WhatsApp rompe el cliente.
    Ver original en ingléswebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS webjs only: connection health check interval in milliseconds (<=0 disables) · valor por defecto 60000
  • TOOL_READY_TIMEOUT_MS Tiempo que las llamadas a herramientas esperan a que el cliente de WhatsApp esté listo antes de devolver un error.
    Ver original en inglésHow long tool calls wait for the WhatsApp client to become ready before erroring
    · valor por defecto 45000
  • MCP_HTTP_PORT When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST Dirección de enlace para el endpoint HTTP (no lo expongas públicamente; el endpoint controla tu cuenta personal de WhatsApp)
    Ver original en inglésBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
    · valor por defecto 127.0.0.1
  • MCP_OAUTH Habilita OAuth para el endpoint HTTP: /mcp requiere un token bearer y los clientes se autentican mediante una página del navegador que muestra el código QR de WhatsApp o el formulario de emparejamiento
    Ver original en inglésEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

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

1 ajuste(s) que rellenar (BROWSER_EXECUTABLE_PATH) · Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server WhatsApp Web MCP Server para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "whatsapp-web": { "command": "npx", "args": [ "-y", "mcp-whatsapp-web" ], "env": { "BROWSER_EXECUTABLE_PATH": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En BROWSER_EXECUTABLE_PATH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de WhatsApp Web MCP Server aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • BROWSER_EXECUTABLE_PATH Solo webjs: ejecutable del navegador. Chrome y Edge se detectan automáticamente; configúralo para usar un navegador específico. Chrome/Edge es necesario para enviar vídeos y GIF.
      Ver original en ingléswebjs only: browser executable. Chrome and Edge are auto-detected; set this to use a specific browser. Chrome/Edge is required for sending videos and GIFs.

    Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

  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 Web MCP Server, BROWSER_EXECUTABLE_PATH está vacío; añade tu clave y guarda

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

  6. Pruébalo

    Usa WhatsApp Web MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si Cursor dice que está usando WhatsApp Web MCP Server o muestra una herramienta de WhatsApp Web MCP Server en la respuesta, ya está conectado

15 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • WHATSAPP_BACKEND Backend de WhatsApp: webjs usa un perfil de navegador persistente; baileys se conecta sin navegador y requiere un emparejamiento separado.
    Ver original en inglésWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
    · valor por defecto webjs
  • BAILEYS_SESSION_DIR Directorio de credenciales de Baileys y del historial sincronizado (predeterminado: /baileys-sessions). Usa una ruta absoluta privada, propiedad de un solo proceso del servidor.
    Ver original en inglésBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL Nivel de registro para el archivo de logs (logs/mcp-whatsapp.log).
    Ver original en inglésLog level for the log file (logs/mcp-whatsapp.log)
    · valor por defecto info
  • LOG_STDERR_LEVEL Nivel de registro para stderr (visible en la mayoría de los logs de clientes MCP).
    Ver original en inglésLog level for stderr (visible in most MCP client logs)
    · valor por defecto warn
  • WHATSAPP_HEADLESS Solo webjs: establezca false para mostrar la ventana del navegador en lugar de ejecutar sin interfaz
    Ver original en ingléswebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX Solo webjs: desactiva explícitamente el sandbox del navegador para contenedores que lo requieran. El sandbox está habilitado por defecto.
    Ver original en ingléswebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
    · valor por defecto false
  • WHATSAPP_SESSION_DIR Solo webjs: directorio persistente del perfil del navegador (predeterminado: /whatsapp-sessions)
    Ver original en ingléswebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER Emparejamiento por número de teléfono: si se define (formato internacional sin símbolos, p. ej. 4915112345678), se registra en stderr un código de emparejamiento de 8 caracteres al iniciar, en lugar de depender del código QR.
    Ver original en inglésPhone number pairing: when set (international, symbol-free format, e.g. 4915112345678), an 8-character pairing code is logged to stderr on startup instead of relying on the QR code
  • FFMPEG_PATH Ruta a un binario de ffmpeg (solo necesaria para reemplazar el ffmpeg instalado automáticamente mediante el paquete npm ffmpeg-static)
    Ver original en inglésPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION Solo webjs: fija la versión de WhatsApp Web si una actualización del lado de WhatsApp rompe el cliente.
    Ver original en ingléswebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS webjs only: connection health check interval in milliseconds (<=0 disables) · valor por defecto 60000
  • TOOL_READY_TIMEOUT_MS Tiempo que las llamadas a herramientas esperan a que el cliente de WhatsApp esté listo antes de devolver un error.
    Ver original en inglésHow long tool calls wait for the WhatsApp client to become ready before erroring
    · valor por defecto 45000
  • MCP_HTTP_PORT When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST Dirección de enlace para el endpoint HTTP (no lo expongas públicamente; el endpoint controla tu cuenta personal de WhatsApp)
    Ver original en inglésBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
    · valor por defecto 127.0.0.1
  • MCP_OAUTH Habilita OAuth para el endpoint HTTP: /mcp requiere un token bearer y los clientes se autentican mediante una página del navegador que muestra el código QR de WhatsApp o el formulario de emparejamiento
    Ver original en inglésEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

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

1 ajuste(s) que rellenar (BROWSER_EXECUTABLE_PATH) · Instala Node.js en tu computadora primero (una sola vez)

Que la IA lo instale

Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.

Instala el MCP server WhatsApp Web MCP Server para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "whatsapp-web": { "type": "stdio", "command": "npx", "args": [ "-y", "mcp-whatsapp-web" ], "env": { "BROWSER_EXECUTABLE_PATH": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En BROWSER_EXECUTABLE_PATH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de WhatsApp Web MCP Server aparecen de verdad.

Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.

  1. Instala Node.js (si no lo tienes)

    ¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter

    node -v
    • Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
    • Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
    Cómo abrir la Terminal

    Mac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter

    Windows: abre Inicio, escribe Windows PowerShell y elige Abrir

    Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl

    Abrir la página de descarga de Node.js ↗

    Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Rellena 1 ajuste(s)

    Son ajustes del programa, no claves. No hace falta registrarse; rellénalos como explica el autor.

    • BROWSER_EXECUTABLE_PATH Solo webjs: ejecutable del navegador. Chrome y Edge se detectan automáticamente; configúralo para usar un navegador específico. Chrome/Edge es necesario para enviar vídeos y GIF.
      Ver original en ingléswebjs only: browser executable. Chrome and Edge are auto-detected; set this to use a specific browser. Chrome/Edge is required for sending videos and GIFs.

    Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

  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 Web MCP Server, BROWSER_EXECUTABLE_PATH está vacío; añade tu clave y guarda

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

  6. Pruébalo

    Usa WhatsApp Web MCP Server y dime qué puedes hacer por mí; luego muéstrame una cosa

    ✓ Si VS Code dice que está usando WhatsApp Web MCP Server o muestra una herramienta de WhatsApp Web MCP Server en la respuesta, ya está conectado

15 ajuste(s) opcional(es) (funciona sin ellos)

El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.

  • WHATSAPP_BACKEND Backend de WhatsApp: webjs usa un perfil de navegador persistente; baileys se conecta sin navegador y requiere un emparejamiento separado.
    Ver original en inglésWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
    · valor por defecto webjs
  • BAILEYS_SESSION_DIR Directorio de credenciales de Baileys y del historial sincronizado (predeterminado: /baileys-sessions). Usa una ruta absoluta privada, propiedad de un solo proceso del servidor.
    Ver original en inglésBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL Nivel de registro para el archivo de logs (logs/mcp-whatsapp.log).
    Ver original en inglésLog level for the log file (logs/mcp-whatsapp.log)
    · valor por defecto info
  • LOG_STDERR_LEVEL Nivel de registro para stderr (visible en la mayoría de los logs de clientes MCP).
    Ver original en inglésLog level for stderr (visible in most MCP client logs)
    · valor por defecto warn
  • WHATSAPP_HEADLESS Solo webjs: establezca false para mostrar la ventana del navegador en lugar de ejecutar sin interfaz
    Ver original en ingléswebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX Solo webjs: desactiva explícitamente el sandbox del navegador para contenedores que lo requieran. El sandbox está habilitado por defecto.
    Ver original en ingléswebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
    · valor por defecto false
  • WHATSAPP_SESSION_DIR Solo webjs: directorio persistente del perfil del navegador (predeterminado: /whatsapp-sessions)
    Ver original en ingléswebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER Emparejamiento por número de teléfono: si se define (formato internacional sin símbolos, p. ej. 4915112345678), se registra en stderr un código de emparejamiento de 8 caracteres al iniciar, en lugar de depender del código QR.
    Ver original en inglésPhone number pairing: when set (international, symbol-free format, e.g. 4915112345678), an 8-character pairing code is logged to stderr on startup instead of relying on the QR code
  • FFMPEG_PATH Ruta a un binario de ffmpeg (solo necesaria para reemplazar el ffmpeg instalado automáticamente mediante el paquete npm ffmpeg-static)
    Ver original en inglésPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION Solo webjs: fija la versión de WhatsApp Web si una actualización del lado de WhatsApp rompe el cliente.
    Ver original en ingléswebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS webjs only: connection health check interval in milliseconds (<=0 disables) · valor por defecto 60000
  • TOOL_READY_TIMEOUT_MS Tiempo que las llamadas a herramientas esperan a que el cliente de WhatsApp esté listo antes de devolver un error.
    Ver original en inglésHow long tool calls wait for the WhatsApp client to become ready before erroring
    · valor por defecto 45000
  • MCP_HTTP_PORT When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST Dirección de enlace para el endpoint HTTP (no lo expongas públicamente; el endpoint controla tu cuenta personal de WhatsApp)
    Ver original en inglésBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
    · valor por defecto 127.0.0.1
  • MCP_OAUTH Habilita OAuth para el endpoint HTTP: /mcp requiere un token bearer y los clientes se autentican mediante una página del navegador que muestra el código QR de WhatsApp o el formulario de emparejamiento
    Ver original en inglésEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

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 Web MCP Server💬 Conversación →
Para desarrolladores: comandos de Terminal y configuración JSON

Instalado en tu computadora

Claude Code

claude mcp add --scope user whatsapp-web --env BROWSER_EXECUTABLE_PATH=your-value -- npx -y mcp-whatsapp-web

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "whatsapp-web": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ],
      "env": {
        "BROWSER_EXECUTABLE_PATH": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "whatsapp-web": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ],
      "env": {
        "BROWSER_EXECUTABLE_PATH": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "whatsapp-web": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-whatsapp-web"
      ],
      "env": {
        "BROWSER_EXECUTABLE_PATH": "your-value"
      }
    }
  }
}

Valores que debes completar

  • WHATSAPP_BACKEND env
    Backend de WhatsApp: webjs usa un perfil de navegador persistente; baileys se conecta sin navegador y requiere un emparejamiento separado.
    Ver original en inglésWhatsApp backend: webjs uses a persistent browser profile; baileys connects without a browser and requires separate pairing
  • BAILEYS_SESSION_DIR env
    Directorio de credenciales de Baileys y del historial sincronizado (predeterminado: /baileys-sessions). Usa una ruta absoluta privada, propiedad de un solo proceso del servidor.
    Ver original en inglésBaileys credentials and synchronized history directory (default: /baileys-sessions). Use a private absolute path, owned by one server process.
  • LOG_LEVEL env
    Nivel de registro para el archivo de logs (logs/mcp-whatsapp.log).
    Ver original en inglésLog level for the log file (logs/mcp-whatsapp.log)
  • LOG_STDERR_LEVEL env
    Nivel de registro para stderr (visible en la mayoría de los logs de clientes MCP).
    Ver original en inglésLog level for stderr (visible in most MCP client logs)
  • WHATSAPP_HEADLESS env
    Solo webjs: establezca false para mostrar la ventana del navegador en lugar de ejecutar sin interfaz
    Ver original en ingléswebjs only: set to false to show the browser window instead of running headless
  • WHATSAPP_NO_SANDBOX env
    Solo webjs: desactiva explícitamente el sandbox del navegador para contenedores que lo requieran. El sandbox está habilitado por defecto.
    Ver original en ingléswebjs only: explicitly disable the browser sandbox for containers that require it. The sandbox is enabled by default.
  • BROWSER_EXECUTABLE_PATH obligatorio env
    Solo webjs: ejecutable del navegador. Chrome y Edge se detectan automáticamente; configúralo para usar un navegador específico. Chrome/Edge es necesario para enviar vídeos y GIF.
    Ver original en ingléswebjs only: browser executable. Chrome and Edge are auto-detected; set this to use a specific browser. Chrome/Edge is required for sending videos and GIFs.
  • WHATSAPP_SESSION_DIR env
    Solo webjs: directorio persistente del perfil del navegador (predeterminado: /whatsapp-sessions)
    Ver original en ingléswebjs only: persistent browser profile directory (default: /whatsapp-sessions)
  • WHATSAPP_PAIRING_PHONE_NUMBER env
    Emparejamiento por número de teléfono: si se define (formato internacional sin símbolos, p. ej. 4915112345678), se registra en stderr un código de emparejamiento de 8 caracteres al iniciar, en lugar de depender del código QR.
    Ver original en inglésPhone number pairing: when set (international, symbol-free format, e.g. 4915112345678), an 8-character pairing code is logged to stderr on startup instead of relying on the QR code
  • FFMPEG_PATH env
    Ruta a un binario de ffmpeg (solo necesaria para reemplazar el ffmpeg instalado automáticamente mediante el paquete npm ffmpeg-static)
    Ver original en inglésPath to an ffmpeg binary (only needed to override the ffmpeg installed automatically via the ffmpeg-static npm package)
  • WA_WEB_VERSION env
    Solo webjs: fija la versión de WhatsApp Web si una actualización del lado de WhatsApp rompe el cliente.
    Ver original en ingléswebjs only: pin the WhatsApp Web version if a WhatsApp-side update breaks the client.
  • HEALTH_CHECK_INTERVAL_MS env
    webjs only: connection health check interval in milliseconds (<=0 disables)
  • TOOL_READY_TIMEOUT_MS env
    Tiempo que las llamadas a herramientas esperan a que el cliente de WhatsApp esté listo antes de devolver un error.
    Ver original en inglésHow long tool calls wait for the WhatsApp client to become ready before erroring
  • MCP_HTTP_PORT env
    When set, additionally exposes the MCP endpoint at http://127.0.0.1: /mcp (Streamable HTTP) from the same process
  • MCP_HTTP_HOST env
    Dirección de enlace para el endpoint HTTP (no lo expongas públicamente; el endpoint controla tu cuenta personal de WhatsApp)
    Ver original en inglésBind address for the HTTP endpoint (do not expose publicly; the endpoint controls your personal WhatsApp account)
  • MCP_OAUTH env
    Habilita OAuth para el endpoint HTTP: /mcp requiere un token bearer y los clientes se autentican mediante una página del navegador que muestra el código QR de WhatsApp o el formulario de emparejamiento
    Ver original en inglésEnable OAuth for the HTTP endpoint: /mcp requires a bearer token and clients authenticate via a browser page showing the WhatsApp QR code / pairing form

Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.

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
76/sem
Conexión
Se ejecuta en tu computadora
Última versióni
1.2.0
Categoríai
Chat y correo
Publicado en el registroi
6 sept 2026
Último cambio de códigoi
11 nov 2026
Creador
mario-andreschak
Paquetes
npm: mcp-whatsapp-web
Sitio web
github.com
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 19 nov 2026

  • ✓ Superada

    El creador coincide con el repo

    El nombre en el registro se verificó con la cuenta de GitHub mario-andreschak, dueña del repo

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hace 8 días

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

Vulnerabilidades publicadas (OSV.dev)

Sin entradas en OSV.dev para mcp-whatsapp-web@1.2.0

Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026

Qué revisamos → · JSON

Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README

Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/mario-andreschak-mcp-whatsapp-web.svg)](https://mcp.popnx.com/en/servers/mario-andreschak-mcp-whatsapp-web)

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 para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

Comparado con otros en Chat y correoi

  • Más estrellas que el 97% de los otros 2024 servidores de esta categoría
  • Publicado en el registro más recientemente que el 23% de los otros 2024 servidores de esta categoría
  • Revisiones básicas iguales o mejores que el 99% de los otros 2024 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 Web MCP Server?

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 8 días, y la última versión (1.2.0) llegó al registro hace 2 meses.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.

¿Qué puedo usar en su lugar?

En la misma categoría: emailmd, Kite Discord Bot Builder, e2a — email for AI agents, Infobip MCP, kernelCAD

Alternativas parecidas

Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego 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

emailmd

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

de anypostMuy usado↓ 5,4 mil/sem★ 1,4 milActualizado hace 5 días

Computadora o nube✓ del servicio · emailmd.dev

Kite Discord Bot Builder

Build and fix Discord bots from a chat. Kite hosts them 24/7, with no code to deploy.

de merlinfuchsEn crecimiento★ 334 Estrellas de todo el repositorioActualizado hace 22 días

Se ejecuta en la nube✓ del servicio · kite.onl

e2a — email for AI agents

Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.

de tokencanopyEn crecimiento★ 200 Estrellas de todo el repositorioActualizado hace 4 meses

Se ejecuta en la nube✓ del servicio · e2a.dev

Infobip MCP

Infobip MCP server for omnichannel communication and messaging. SMS, RCS, WhatsApp, Viber and more.

de infobipInicial★ 36Actualizado hace 13 meses

Se ejecuta en la nube✓ del servicio · infobip.com

kernelCAD

CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.

de w1neInicial★ 35Actualizado hace 23 días

Se ejecuta en la nube✓ del servicio · kernelcad.com
Comparado con otros parecidos
Este
WhatsApp Web MCP Server
emailmdKite Discord Bot Buildere2a — email for AI agentsInfobip MCPkernelCAD
Dónde se ejecutaSe instala en tu equipoEn la nube o instalado en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoNoNoNo
Se añade con + en ClaudeNoNoNoNoSíNo
Revisiones básicas3/35/54/44/44/44/4
LicenciaMITMITAGPL-3.0Apache-2.0MITMIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registro

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.

Very Important

Automation of Whatsapp Messages without Meta (Business-)API is against WhatsApp' Terms of Service! You take full responsibility for everything you do with this MCP-Server. It is possible that your account will be flagged/restricted.

MCP WhatsApp Web (TypeScript)

A Model Context Protocol (MCP) server for WhatsApp Web, implemented in TypeScript. This project is a TypeScript port of the original whatsapp-mcp repository.

With this MCP server, you can:

  • Search and read your personal WhatsApp messages (including media)
  • Search your contacts
  • Send messages to individuals or groups
  • Send and receive media files (images, videos, documents, audio)

Features

  • TypeScript Implementation: Fully typed codebase for better developer experience and code reliability
  • Selectable WhatsApp Backend: Uses whatsapp-web.js by default, with an optional Baileys backend that runs without a browser
  • MCP Server: Implements the Model Context Protocol for seamless integration with AI assistants
  • Media Support: Send and receive images, videos, documents, and audio messages
  • Webhooks (Baileys): signed notifications for new messages and for incoming calls, including who is calling
  • Multiple Transport Options: Supports stdio and Streamable HTTP transports — even both at once from a single process (start with stdio and set MCP_HTTP_PORT to additionally expose http://127.0.0.1: /mcp, or run HTTP-only with --http)
  • Flexible Authentication: QR code (as an MCP image tool), pairing code (request_pairing_code tool, or automatically printed to stderr at startup via WHATSAPP_PAIRING_PHONE_NUMBER), and an optional OAuth flow for HTTP clients (MCP_OAUTH=true) where the browser authorization page shows the WhatsApp QR code — unlinking WhatsApp revokes tokens so clients automatically re-authenticate

Architecture

This MCP server consists of:

  1. TypeScript MCP Server: Implements the Model Context Protocol to provide standardized tools for AI assistants to interact with WhatsApp
  2. WhatsApp Backend: A shared service interface selects web.js/Puppeteer or Baileys/WebSocket, handles authentication, and manages message sending/receiving
  3. Tool Implementations: Provides various tools for contacts, chats, messages, media, and authentication

Prerequisites

  • Node.js >= 22.0.0 (Node 22 or 24 recommended for the Baileys SQLite dependency)
  • npm or yarn
  • For the default webjs backend: Google Chrome or Microsoft Edge (auto-detected; needed for video/GIF codec support; other operations can use Puppeteer's bundled Chromium)
  • For baileys: install optional dependencies, including the native better-sqlite3 module. No Chrome, Edge, or Chromium is needed at runtime.

FFmpeg is bundled automatically via the ffmpeg-static npm package — no manual installation needed. You can point the FFMPEG_PATH environment variable at your own binary to override it.

Installation

npx
   npx mcp-whatsapp-web
Manual Installation
  1. Clone this repository
   git clone https://github.com/mario-andreschak/mcp-whatsapp-web.git

cd mcp-whatsapp-web

  1. Install dependencies
   npm install
  1. Build the project
   npm run build
  1. Configure environment variables (optional)

Copy the example environment file and modify as needed:

   cp .env.example .env

You can select the backend with WHATSAPP_BACKEND, adjust logging levels, pin the WhatsApp Web version, or override the auto-detected browser (BROWSER_EXECUTABLE_PATH) and ffmpeg binary (FFMPEG_PATH). WHATSAPP_HEADLESS=false shows the web.js browser window, and WHATSAPP_SESSION_DIR relocates its persistent profile. Without these settings the sign-in is kept in a fixed place for your user account, so it no longer matters which folder a program starts the server from (see Keeping the link).

Choosing a backend

WHATSAPP_BACKEND=webjs is the default and preserves existing sessions and MCP tool names. It uses a dedicated persistent LocalAuth profile, not your personal Chrome profile. It now keeps the browser's native user agent and graphics defaults, omits Puppeteer's automation banner flag, and leaves the browser sandbox enabled. Containers that require disabling the sandbox can explicitly set WHATSAPP_NO_SANDBOX=true. These settings do not guarantee that automation is undetectable.

To use the optional Baileys backend, set these variables in your MCP client configuration or .env, then restart the server:

WHATSAPP_BACKEND=baileys

Optional: where the sign-in lives. Leave it out to use the standard place.

#BAILEYS_SESSION_DIR=C:/path/to/your/baileys-sessions

BAILEYS_SESSION_DIR is optional; without it the sign-in lives in the standard place described in Keeping the link. Pair this backend separately with get_qr_code or request_pairing_code. The existing WHATSAPP_PAIRING_PHONE_NUMBER option also works. Baileys cannot reuse the web.js browser profile. You can switch back to webjs and resume its existing session.

Baileys links as a Chrome device (shown as "Chrome (Windows)" or "Chrome (Mac OS)" under Linked devices). WhatsApp currently ends new links that claim to be the Desktop app with status 428 ("Connection Terminated") before a QR code appears. Desktop would request the full chat history; Chrome receives recent history, and live messages are stored from then on. BAILEYS_BROWSER=Desktop restores the old behaviour. At startup the backend also looks up the current WhatsApp Web version from web.whatsapp.com, because WhatsApp refuses clients that report an outdated one; WA_WEB_VERSION pins it, and a failed lookup falls back to the version bundled with Baileys.

Baileys and SQLite are pinned optional dependencies installed by normal npm install. If your package manager omitted them, run npm install --include=optional. SQLite uses a native addon; a supported prebuilt binary or a local native build toolchain is required. To avoid downloading Chromium when installing for Baileys or an existing system browser, use:

$env:PUPPETEER_SKIP_DOWNLOAD = 'true'

npm install --include=optional npm run build

On macOS/Linux, the equivalent installation command is PUPPETEER_SKIP_DOWNLOAD=true npm install --include=optional. Selecting Baileys loads only its driver and never starts or cleans up browser processes. An unavailable backend produces an error; it never silently switches drivers or retries a send through another backend.

Baileys sessions and history
  • Credentials, Signal keys, contacts, chats and messages persist in session.sqlite inside the sign-in folder. Keep the whole folder private and out of version control. Only one running server may own a sign-in folder. Use separate folders for independent accounts.
  • Normal shutdown and lost connections keep the sign-in. Only a clear "this device was removed" from WhatsApp, or the logout tool, ends it; both revoke the OAuth access tokens. Baileys HTTP OAuth state is stored separately from web.js in oauth-store.json inside the sign-in folder.
  • get_backend_status reports the active backend, authentication, stored record counts and history synchronization state. Being connected does not mean history has finished arriving. An available history state means local data is available, not that WhatsApp supplied a complete archive.
  • Contact and history tools query the local synchronized store. Initial full-history sync is requested and can take time on large accounts. list_messages may request up to 100 additional older messages when a known chat has fewer than requested, with a bounded wait and a per-chat cooldown. Late history batches are persisted for subsequent queries. WhatsApp may still supply only part of an account's history.
  • Treat returned message IDs as opaque and use IDs from the active backend. Legacy @c.us phone-number inputs, @s.whatsapp.net, groups and @lid identifiers are supported; known LID/phone mappings are persisted. Message IDs from web.js cannot be passed to Baileys or vice versa.
  • Text, media, downloads, voice notes and the existing authentication tools use the same MCP interface. Voice-note inputs must be local files or base64; FFmpeg converts them to mono Opus/Ogg before sending. If conversion fails, the tool reports an error without sending a different message type.

The Baileys backend is opt-in and pinned to 7.0.0-rc14. Review upstream changes before upgrading, especially authentication and message-format migrations. See the Baileys documentation and release history.

Keeping the link

You should only need to scan the QR code once. After that the server stays linked, even when it is restarted, started by a different program, or loses its internet connection for a while.

Where the sign-in lives. By default the sign-in is kept in one fixed place for your user account, whatever folder a program starts the server from:

SystemBaileysweb.js
Windows%LOCALAPPDATA%\mcp-whatsapp-web\baileys-sessions%LOCALAPPDATA%\mcp-whatsapp-web\whatsapp-sessions
macOS~/Library/Application Support/mcp-whatsapp-web/baileys-sessions~/Library/Application Support/mcp-whatsapp-web/whatsapp-sessions
Linux~/.local/share/mcp-whatsapp-web/baileys-sessions (or under $XDG_DATA_HOME)~/.local/share/mcp-whatsapp-web/whatsapp-sessions
  • If you set BAILEYS_SESSION_DIR (or WHATSAPP_SESSION_DIR for web.js), that folder is always used.
  • Older versions kept the sign-in in a baileys-sessions (or whatsapp-sessions) folder inside the folder the server was started from. If such a sign-in exists and no folder is set, the server keeps using it and says so in its log.
  • At start the log says which folder is used and whether it holds a sign-in. get_backend_status shows it too, as connection.signInFolder.

Moving the sign-in. Stop every program that runs the server, move the whole folder (all files in it) to the new place, then either put it in the standard place above or point BAILEYS_SESSION_DIR at it, and start the server again.

Using it from more than one program. Two programs cannot share one sign-in at the same time. The second one waits and takes over by itself when the first one closes. If both should run at the same time, give the second program its own folder (BAILEYS_SESSION_DIR) and link it as its own device by scanning a new QR code. WhatsApp allows several linked devices per phone. Never copy a sign-in folder to a second program: the two copies would keep pushing each other off.

When the connection drops. The server reconnects by itself: quickly at first, then every five minutes for as long as it runs, so it recovers on its own when the network comes back. Asking for WhatsApp (for example check_auth_status or any tool) makes it try again at once. get_backend_status tells you in plain words what is going on: connection.state is linked, reconnecting, waiting_for_link, waiting_for_other_program or stopped, with since, lastReason and the next attempt.

What really ends a link. Only these need a new QR code:

  • The device was removed under Settings > Linked devices on the phone, or with the logout tool.
  • The phone was offline for a long time (WhatsApp ends linked devices after about 14 days without the phone).
  • WhatsApp itself ends the link, for examp

Solo se muestra el principio; lee el resto en el repo