How verygoodplugins/whatsapp-mcp works
WhatsApp MCP exposes messaging tools to an MCP client, with a Python server calling a local Go bridge that maintains the WhatsApp session and local message history. The README documents this startup flow and the product’s messaging, media, read-receipt, call-history, and webhook capabilities. The sampled sources show MCP-to-client module references, media helpers, bridge authentication, history handling, and webhook delivery; unsampled handler wiring is represented only where documented.
Main entry points: main.py MCP tools · main.go WhatsApp runtime · whatsapp.py Bridge client · webhook.go Webhook delivery
Components 15
MCP interface
- MCP tools
whatsapp-mcp-server/main.py - Transport config
whatsapp-mcp-server/mcp_config.py - Parent watchdog
whatsapp-mcp-server/parent_watchdog.py
WhatsApp access
- Bridge client
whatsapp-mcp-server/whatsapp.py - Message store
whatsapp-bridge/main.go
WhatsApp bridge
- WhatsApp runtime
whatsapp-bridge/main.go - Bridge authentication
whatsapp-bridge/auth.go - On-demand history
whatsapp-bridge/history_ondemand.go - Webhook delivery
whatsapp-bridge/webhook.go
Media processing
- Media previews
whatsapp-mcp-server/media_preview.py - Audio transcription
whatsapp-mcp-server/transcription.py - Audio conversion
whatsapp-mcp-server/audio.py
Other components
- Claude or Cursor
- WhatsApp service
- Webhook receiver
Connections 15
- Claude or Cursor → MCP tools: invokes tools
README.md - MCP tools → Bridge client: calls
whatsapp-mcp-server/main.py - MCP tools → Transport config: configures transport
whatsapp-mcp-server/main.py - MCP tools → Parent watchdog: starts watchdog
whatsapp-mcp-server/main.py - Bridge client → WhatsApp runtime: calls local API
README.md - WhatsApp runtime → Bridge authentication: loads token
whatsapp-bridge/main.go - WhatsApp runtime → Message store: stores messages
README.md - WhatsApp runtime → WhatsApp service: connects session
README.md - WhatsApp runtime → On-demand history: serves history requests
whatsapp-bridge/history_ondemand.go - WhatsApp runtime → Webhook delivery: forwards messages
whatsapp-bridge/webhook.go - Webhook delivery → Webhook receiver: posts events
whatsapp-bridge/webhook.go - MCP tools → Media previews: renders media
whatsapp-mcp-server/main.py - MCP tools → Audio transcription: transcribes audio
whatsapp-mcp-server/main.py - Bridge client → Audio conversion: converts audio
whatsapp-mcp-server/whatsapp.py - MCP tools → Message store: reads local history
README.md