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 npm install line lands in your inbox once you submit your email above.

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 welcome email 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.

   We send the exact JSON for Claude Code, Claude Desktop, Cursor, VS Code, and Windsurf once you submit your email above. Configs differ only by file path; the server entry is identical.

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.”