How do I install the Whatsapp MCP skill?

Run npx skillmds@latest add adam-s-builder-club/whatsapp-mcp in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Whatsapp MCP safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: CAUTION, Skill Scanner: WARNING. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Whatsapp MCP?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Whatsapp MCP free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Whatsapp MCP?

Adam-s-Builder-Club (@adam-s-builder-club) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Whatsapp MCP by adam-s-builder-club

Name: Whatsapp MCP
Rating: 4.5 (4 reviews)
Author: Adam-s-Builder-Club

Whatsapp MCP

Install and manage the WhatsApp MCP for Claude Desktop / Claude Code on macOS. Bridge syncs WhatsApp Web → local SQLite; the patched MCP server resolves contacts against the user's iPhone/Android address book (no more raw phone numbers in query results). Use when asked to "install whatsapp", "set up whatsapp mcp", "connect whatsapp to claude", or any first-time WhatsApp + Claude setup. Also handles --update, --uninstall, --reimport.

File contents

/whatsapp-mcp

Installs github.com/lharries/whatsapp-mcp pinned to a known-good SHA, builds the Go bridge, patches the Python MCP server's name resolution against the user's iPhone/Android contacts, writes the Claude Desktop + Claude Code MCP config blocks, and installs a launchd plist that auto-starts the bridge on login.

What this skill does

Checks platform (macOS only for v0.1.x)
Installs Homebrew, Go ≥1.25, uv (if missing)
Clones lharries/whatsapp-mcp and pins to upstream PR #253 fix-405 branch (asserts SHA equality — aborts on mismatch with clear remediation)
Builds the Go bridge
Patches the Python MCP server's dataclass __post_init__ so chat/contact/message names resolve against ~/.whatsapp-mcp/contacts.json
Writes the whatsapp MCP entry to both claude_desktop_config.json and ~/.claude.json (atomic, preflight-validated)
Installs a launchd plist with WorkingDirectory + log paths + ThrottleInterval=30 (per-user filename so multi-user Macs don't clobber each other)
Runs the bridge in the foreground first so the user can see + scan the QR code, then hands off to launchd once "✓ Connected to WhatsApp!" log line appears
Tells the user to run /whatsapp-import-contacts to populate name resolution

How to invoke

bash ~/.whatsapp-mcp/skill-repo/install.sh

If the skill repo isn't cached locally yet (first-time run via slash command), bootstrap it:

curl -fsSL https://raw.githubusercontent.com/Adam-s-Builder-Club/whatsapp-mcp-skill/v0.1.1/install.sh | bash

Day-2 commands:

bash ~/.whatsapp-mcp/skill-repo/install.sh --update      # pull latest skill release, re-patch, restart bridge
bash ~/.whatsapp-mcp/skill-repo/install.sh --reauth      # bootout + re-scan QR (after 20-day session expiry or repeated auth-failure)
bash ~/.whatsapp-mcp/skill-repo/install.sh --reimport    # re-import contacts from vCard + macOS Contacts.app
bash ~/.whatsapp-mcp/skill-repo/install.sh --uninstall   # stop bridge, remove launchd plist, un-merge Claude config

What to tell the user before running

Before kicking off the install, surface:

The install will request macOS permissions (Contacts via TCC, possibly Homebrew sudo on a clean Mac).
The user will need to scan a QR code with their phone's WhatsApp app during install (Settings → Linked Devices → Link a Device).
After install they should restart Claude Desktop / Claude Code so the new MCP server is picked up.
Security caveat (light touch): WhatsApp MCPs are subject to the "lethal trifecta" — once installed, prompt-injected content arriving via WhatsApp could in theory cause the model to exfiltrate other messages. See the repo README for the full caveat. Don't pair this skill with auto-reply / auto-forward skills.

How to detect already-installed

If ~/.whatsapp-mcp/skill-repo/ exists and launchctl print gui/$(id -u)/com.user.$USER.whatsapp-bridge returns success, the skill is already installed. Suggest --update (latest release), --reimport (refresh contacts), or --uninstall (clean removal) instead of re-running install.

After install

Recommend the user immediately run /whatsapp-import-contacts so chat/contact names resolve against their real address book instead of showing raw phone numbers like 919949938166@s.whatsapp.net.

---name: whatsapp-mcpdescription: Install and manage the WhatsApp MCP for Claude Desktop / Claude Code on macOS. Bridge syncs WhatsApp Web → local SQLite; the patched MCP server resolves contacts against the user's iPhone/Android address book (no more raw phone numbers in query results). Use when asked to "install whatsapp", "set up whatsapp mcp", "connect whatsapp to claude", or any first-time WhatsApp + Claude setup. Also handles --update, --uninstall, --reimport.---# /whatsapp-mcpInstalls github.com/lharries/whatsapp-mcp pinned to a known-good SHA, builds the Go bridge, patches the Python MCP server's name resolution against the user's iPhone/Android contacts, writes the Claude Desktop + Claude Code MCP config blocks, and installs a launchd plist that auto-starts the bridge on login.## What this skill does1. Checks platform (macOS only for v0.1.x)2. Installs Homebrew, Go ≥1.25, uv (if missing)3. Clones lharries/whatsapp-mcp and pins to upstream PR #253 fix-405 branch (asserts SHA equality — aborts on mismatch with clear remediation)4. Builds the Go bridge5. Patches the Python MCP server's dataclass `__post_init__` so chat/contact/message names resolve against `~/.whatsapp-mcp/contacts.json`6. Writes the `whatsapp` MCP entry to both `claude_desktop_config.json` and `~/.claude.json` (atomic, preflight-validated)7. Installs a launchd plist with `WorkingDirectory` + log paths + `ThrottleInterval=30` (per-user filename so multi-user Macs don't clobber each other)8. Runs the bridge in the foreground first so the user can see + scan the QR code, then hands off to launchd once `"✓ Connected to WhatsApp!"` log line appears9. Tells the user to run `/whatsapp-import-contacts` to populate name resolution## How to invoke```bashbash ~/.whatsapp-mcp/skill-repo/install.sh```If the skill repo isn't cached locally yet (first-time run via slash command), bootstrap it:```bashcurl -fsSL https://raw.githubusercontent.com/Adam-s-Builder-Club/whatsapp-mcp-skill/v0.1.1/install.sh | bash```Day-2 commands:```bashbash ~/.whatsapp-mcp/skill-repo/install.sh --update # pull latest skill release, re-patch, restart bridgebash ~/.whatsapp-mcp/skill-repo/install.sh --reauth # bootout + re-scan QR (after 20-day session expiry or repeated auth-failure)bash ~/.whatsapp-mcp/skill-repo/install.sh --reimport # re-import contacts from vCard + macOS Contacts.appbash ~/.whatsapp-mcp/skill-repo/install.sh --uninstall # stop bridge, remove launchd plist, un-merge Claude config```## What to tell the user before runningBefore kicking off the install, surface:1. The install will request macOS permissions (Contacts via TCC, possibly Homebrew sudo on a clean Mac).2. The user will need to **scan a QR code with their phone's WhatsApp app** during install (Settings → Linked Devices → Link a Device).3. After install they should restart Claude Desktop / Claude Code so the new MCP server is picked up.4. **Security caveat (light touch):** WhatsApp MCPs are subject to the "lethal trifecta" — once installed, prompt-injected content arriving via WhatsApp could in theory cause the model to exfiltrate other messages. See the repo README for the full caveat. Don't pair this skill with auto-reply / auto-forward skills.## How to detect already-installedIf `~/.whatsapp-mcp/skill-repo/` exists and `launchctl print gui/$(id -u)/com.user.$USER.whatsapp-bridge` returns success, the skill is already installed. Suggest `--update` (latest release), `--reimport` (refresh contacts), or `--uninstall` (clean removal) instead of re-running install.## After installRecommend the user immediately run `/whatsapp-import-contacts` so chat/contact names resolve against their real address book instead of showing raw phone numbers like `919949938166@s.whatsapp.net`.

Frequently asked questions