Install

Install in under a minute

macOS 13+ with the WhatsApp desktop app installed. Node.js 20+ for the npm install. Xcode Command Line Tools for the Swift compile.

1. 01

   Install the npm package

   The postinstall script runs xcrun swift build -c release to compile the Swift binary. First install takes ~30 seconds. The exact command appears in the modal above once you submit your email.

2. 02

   Grant Accessibility permission

   macOS requires the host app (Claude Desktop, Terminal, Cursor, Windsurf, Fazm, whichever launches the MCP server) to be granted Accessibility permission. Open System Settings → Privacy & Security → Accessibility, click the + button, and add the host app. Toggle it on.

   If the toggle is on but tools fail, remove the entry and re-add it. The TCC database sometimes caches stale permissions.

3. 03

   Register the MCP server

   Drop the JSON config from the install modal into ~/.claude.json (Claude Code) or the equivalent file for your MCP client. Restart the client. The WhatsApp MCP server should appear in the available tool list.

   Suppressed for the unauthenticated view; the modal above contains the exact JSON for whatsapp-mcp-macos.

4. 04

   Try it

   Open WhatsApp on your Mac (the server expects the app to be running). Then ask your assistant something like “Search WhatsApp for Mom and tell me her last three messages.”