Skip to content

v0.0.1 — first release

Choose a tag to compare

@joaohts joaohts released this 03 Jun 03:17
· 13 commits to main since this release

First public release of WhatsApp MCP for macOS. Read-only WhatsApp access for Claude Desktop and Claude Code, fully local.

Install (Apple Silicon Macs, macOS 14+)

  1. Download WhatsAppMCP-0.0.1-arm64.dmg below
  2. Open the DMG, drag WhatsAppMCP to Applications
  3. Right-click WhatsAppMCP in /Applications → Open the first time (unsigned build — macOS records the approval after that)
  4. Pair your WhatsApp (phone-number code or QR)
  5. Click Configurar Claude Desktop, then restart Claude Desktop
  6. Ask Claude something like "quais são minhas conversas não lidas do WhatsApp?"

Known caveats

  • arm64 only. Intel Macs not supported.
  • Unsigned. Right-click → Open on first launch, or System Settings → Privacy & Security → Open Anyway.
  • Read-only. Never sends messages, never marks anything read, never changes your presence — by code structure, not just contract.
  • WhatsApp can take a few seconds to push the first history chunks after pairing; the wizard waits.

What's in the DMG

  • Electron + Baileys + SQLite (better-sqlite3), all bundled — zero system prerequisites
  • pt-BR UI
  • Per-tool toggles in Configurações
  • Server-level prompt-injection posture sent in the MCP instructions field
  • Notify-only update checks against GitHub Releases