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 Iniciar sesión

WhatsApp MCP

de muhammedanasmithadiversión 0.2.0i★ 0iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.muhammedanasmithadi/whatsapp-mcp

Cómo instalar

Qué hace

Self-hosted personal WhatsApp bridge with 86 MCP tools over stdio or Streamable HTTP.

Texto original del autor

  • Conexión Se ejecuta en tu computadora
  • Cuenta o clave No necesita clave
  • Categoría Chat y correo

Por qué está en este puesto

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

Popularidad0/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 uso12/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.

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

Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

  1. Descarga el instalador del autor

    Descargar el archivo .mcpb del creador

    El archivo .mcpb viene directo del autor; no lo modificamos

  2. Haz doble clic en el archivo y pulsa Install en la app de Claude de escritorio

  3. Pruébalo

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

    ✓ Si Claude dice que está usando WhatsApp MCP o muestra una herramienta de WhatsApp MCP 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 MCP

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

  • Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

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

Claude Code todavía no puede conectar WhatsApp MCP

El autor solo ofrece un instalador para la app de Claude de escritorio

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar WhatsApp MCP

  • Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

Cursor todavía no puede conectar WhatsApp MCP

El autor solo ofrece un instalador para la app de Claude de escritorio

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar WhatsApp MCP

  • Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

VS Code todavía no puede conectar WhatsApp MCP

El autor solo ofrece un instalador para la app de Claude de escritorio

Lo que puedes hacer en su lugar

A · Usa una app que pueda conectar WhatsApp MCP

  • Sin clave y sin instalar nada · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil

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 MCP💬 Conversación →

De un vistazo

Descargas por semanai
No está en npm/PyPI
Conexión
Se ejecuta en tu computadora
Última versióni
0.2.0
Categoríai
Chat y correo
Publicado en el registroi
20 nov 2026
Último cambio de códigoi
20 nov 2026
Creador
muhammedanasmithadi
Paquetes
mcpb: …/whatsapp-mcp_0.2.0_darwin_amd64.mcpb
mcpb: …/whatsapp-mcp_0.2.0_darwin_arm64.mcpb
mcpb: …/whatsapp-mcp_0.2.0_linux_amd64.mcpb
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 StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex 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 20 nov 2026

  • ✓ Superada

    El creador coincide con el repo

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

  • ✓ Superada

    Sigue en mantenimiento

    Último cambio de código: hoy

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

No revisado: solo se pueden revisar paquetes npm y PyPI con versión

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/muhammedanasmithadi-whatsapp-mcp.svg)](https://mcp.popnx.com/en/servers/muhammedanasmithadi-whatsapp-mcp)

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

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 hoy, y la última versión (0.2.0) llegó al registro hoy.

¿Qué apps pueden usarlo?

Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas MCPB 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 6 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★ 332 Estrellas de todo el repositorioActualizado hace 23 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 24 días

Se ejecuta en la nube✓ del servicio · kernelcad.com
Comparado con otros parecidos
Este
WhatsApp MCP
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.

WhatsApp MCP

A self-hosted Model Context Protocol (MCP) server that gives an AI agent read and send access to your personal WhatsApp account. It runs on your machine as a single Go binary, speaks MCP over Streamable HTTP at 127.0.0.1:8765/mcp, and keeps your message history in a local SQLite database.

This is an independent, community project. It is not affiliated with, endorsed by, or operated by Meta Platforms, Inc. or WhatsApp LLC.

What it does

Once paired with your phone (the same way you link WhatsApp Web), the daemon:

DomainWhat it does
MessagesRead, search, send, edit, delete, and recover messages; read receipts; mark read; schedule messages; reply; react; poll; contact cards; locations; voice-note transcription
Statuses (Stories)Read, view, post, delete statuses; read receipts; status privacy setting
ProfileRead/set About text, profile photo, contact metadata (About, verified name, LID, linked devices)
PresenceQuery contact online/last-seen; set per-chat typing/recording indicators
GroupsCreate, leave, join via link, participants, name, topic, announce, lock, invite link
ChannelsFollow/unfollow, mute, list, info, messages
ContactsLocal address book (bridge-only; not synced to the phone), search, create, update, delete
Blocklist & PrivacyBlocklist, privacy settings (group add, last seen, status, profile, read receipts, online, calls, messages, defense, stickers)
SchedulingTimer-driven scheduled messages that survive restarts
Auto-responderEvent-driven out-of-office replies to incoming 1:1 text messages
Audit & observabilityAudit log, health check, Prometheus metrics, WebSocket events, SSE pairing events

The daemon exposes 86 MCP tools over Streamable HTTP, serves health (/healthz) and Prometheus metrics (/metrics), and pushes new messages to connected clients over WebSocket (/ws/events).

Architecture

┌─────────────────┐      Streamable HTTP      ┌─────────────────────┐

│ AI agent │◄─────────────────────────►│ whatsapp-mcp │ │ (Claude, etc.) │ /mcp │ MCP server (Go) │ └─────────────────┘ │ • 86 tool handlers │ │ • rate limiting │ │ • SQLite cache │ └──────────┬──────────┘ │ │ whatsmeow multidevice │ protocol (vendored fork) ▼ ┌─────────────────────┐ │ WhatsApp Web │ │ (linked device) │ │ phone ↔ server │ └─────────────────────┘

The daemon wraps whatsmeow, the Go WhatsApp Web multidevice library. Because WhatsApp changes its protocol server-side without notice, the project vendors whatsmeow via a Go replace directive and applies protocol fixes immediately rather than waiting for upstream:

replace go.mau.fi/whatsmeow => ./vendor-whatsmeow/go.mau.fi/whatsmeow

Protocol fixes carried in the fork (also contributed upstream where applicable):

FixWhat it does
SKDM group IDhandleSenderKeyDistributionMessage uses the protobuf groupId, not the enclosing stanza chat, to decide sender-key ownership. This makes statuses and group messages decrypt correctly when retried as direct-to-device SKDMs. Upstream: tulir/whatsmeow#1330
Profile picture tctokenMedia requests include the required token so thumbnails resolve
Presence subscribeMissing id attribute added to presence subscription stanzas
Argo decodingHard-coded failure and macOS early-return removed
SendPresence racePresence updates no longer race with session teardown
GetPrivacySettingsErrors are no longer swallowed
set_status_messageWhatsApp Web calls the xwa2_update_text_status MEX mutation (ID 9152604461510864) first, then the legacy stanza. The MEX mutation is account-gated and fails with a 400 CRITICAL error on accounts without the text-status feature, so it is sent only when an emoji or ephemeral duration is requested; the legacy IQ is always sent
canonicalContactJIDWrong suffix @s.client.net → @s.whatsapp.net fixed

Quick start

Prerequisites
  • Go 1.26+ (build-time only; runtime needs just the compiled binary)
  • FFmpeg (optional, for voice-note transcoding via send_audio_message)
  • An MCP client that speaks HTTP (Claude Desktop, Cursor, Claude Code, OpenCode, etc.)
Build

Download a prebuilt binary from the latest release. Release assets cover Linux (amd64, arm64), macOS (amd64, arm64) and Windows (amd64), with SHA-256 sums in checksums.txt. The binary needs no runtime dependencies except FFmpeg for voice-note transcoding.

Or build from source:

git clone https://github.com/muhammedanasmithadi/whatsapp-mcp.git

cd whatsapp-mcp make build # writes ./bin/whatsapp-mcp

Pair your phone

Start the daemon, then open the pairing page:

./bin/whatsapp-mcp serve          # starts on 127.0.0.1:8765

Visit http://127.0.0.1:8765/pair, scan the QR code with WhatsApp (Settings → Linked Devices → Link a Device), and the session persists to ./store/whatsapp.db. WhatsApp rotates the session roughly every 20 days; the daemon re-pairs automatically with exponential backoff.

No browser? Run ./bin/whatsapp-mcp login to render the QR in the terminal, or use the phone-number form on /pair.

Connect your MCP client

Add this to your client configuration:

// OpenCode (opencode.jsonc), Claude Code, Cursor, etc.

{ "mcpServers": { "whatsapp": { "type": "http", "url": "http://127.0.0.1:8765/mcp" } } }

Restart your client. The daemon outlives client restarts.

One-click install with MCPB

Each release also ships a .mcpb bundle for Linux, macOS and Windows. Install the bundle matching your platform in an MCPB-capable desktop client; the client starts the binary over stdio and fills in the configuration for you.

Pair once before installing the bundle, because stdio mode has no browser to show a QR code:

whatsapp-mcp -store ~/.whatsapp-mcp login

The bundle's store_dir setting defaults to ~/.whatsapp-mcp, and its read_only setting maps to WHATSAPP_MCP_READ_ONLY. To run stdio mode by hand:

whatsapp-mcp -store ~/.whatsapp-mcp stdio -read-only

stdout carries JSON-RPC frames only; every diagnostic goes to stderr.

Serve flags and environment

Flag / env varDefaultPurpose
-addr / WHATSAPP_MCP_ADDR127.0.0.1:8765HTTP bind address
-allow-remoteoffBind to a non-loopback address (requires WHATSAPP_MCP_TOKEN)
WHATSAPP_MCP_TOKEN—Bearer token for /mcp and /pair/* when remote-bound
-read-only / WHATSAPP_MCP_READ_ONLYoffExpose only read/query tools (no send, edit, delete, mark-read, group, blocklist, privacy, status-change tools)
-log-format / WHATSAPP_MCP_LOG_FORMATtexttext for human logs; json for structured JSON lines
WHATSAPP_MCP_MEDIA_ROOT /uploads/File allowlist root for send/download tools
WHATSAPP_MCP_DEVICE_NAMEWhatsApp MCPName shown for this device in WhatsApp → Linked Devices
WHATSAPP_MCP_FULL_HISTORY_SYNCoffBackfill older messages for all cached chats after pairing
-debug / WHATSAPP_MCP_DEBUGoffVerbose (unredacted) logs
Observability
  • GET /healthz — JSON: connected, paired, state, uptime_sec
  • GET /metrics — Prometheus text format: messages in/out, sends, errors, rate-limited, pairing state, uptime
Real-time push
  • WS /ws/events — WebSocket broadcast of new-message events as JSON
  • GET /pair/events — Server-Sent Events stream of pairing state transitions

MCP tools reference

The server exposes 86 tools, grouped by domain:

Messaging
ToolDescription
send_messageSend a text message to a person or group
send_fileUpload and send a picture, video, document, or attachment
send_audio_messageSend an audio file as a voice note (transcodes via ffmpeg if needed)
send_locationSend a map location
send_contact_cardSend a contact card (vCard)
send_pollSend a poll with 2–32 options
send_poll_voteCast a vote on a poll
send_reactionAdd or replace an emoji reaction on a message
send_replySend a reply that quotes a previous message
edit_messageEdit the text of a sent message
delete_messageRevoke (delete) a sent message
recover_mediaRequest WhatsApp to re-send media for a message
transcribe_voice_noteTranscribe a voice note via the configured STT endpoint
batch_send_messagesSend multiple messages in one call
Statuses (Stories)
ToolDescription
list_status_updatesList cached Status updates grouped by sender
mark_status_viewedSend read receipts for a contact's statuses
send_statusPost a Status update (image/video + caption)
delete_statusDelete one of your own status updates
get_status_viewersViewers of a status (WhatsApp does not expose this to linked devices; returns empty list with a note)
set_status_privacy_settingSet who can see your statuses (all, contacts, close_friends, custom)
Profile & presence
ToolDescription
get_contact_infoLive profile metadata (About, profile-picture ID, LID, devices, business verification)
get_profile_pictureFetch a contact's or group's profile photo
set_profile_pictureSet the paired account's profile photo
set_status_messageSet the About text shown in the profile
get_presenceQuery a contact's online/last-seen state
send_typingShow or hide per-chat typing/recording indicator
send_presenceSet global online/offline availability
Groups
ToolDescription
create_groupCreate a group with participants
leave_groupLeave a group
join_group_with_linkJoin a group via invite link
get_group_infoGet group metadata
get_group_invite_linkGet or reset a group invite link
set_group_nameRename a group
set_group_topicSet group topic/description
set_group_announceSet announce-only mode
set_group_lockedLock/unlock a group
update_group_participantsAdd/remove/promote/demote participants
mute_chatMute/unmute a chat
pin_chatPin/unpin a chat in the chat list
Channels
ToolDescription
list_channelsList followed WhatsApp Channels
follow_channelFollow a channel
unfollow_channelUnfollow a channel
mute_channelMute/unmute a channel
get_channel_infoGet channel metadata
list_channel_messagesList messages from a channel
Contacts
ToolDescription
list_contactsList local address-book contacts
create_contactCreate a local contact entry
update_contactUpdate a local contact

| delete_contact | Delete a

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