WhatsApp MCP Server

That's it. The batch file handlesnpm installand config automatically. No PowerShell, no manual editing.

git clone https://github.com/khetsinghrajput/WhatsApp-MCP-Local.git cd WhatsApp-MCP-Local make install

Nomake? Use:chmod +x install.sh && ./install.sh

Windows PowerShell error?If you see "running scripts is disabled", run this once in PowerShell then retry:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

Or just useinstall.batinstead — it uses cmd.exe which never has this problem.

✅ Done! Config written: Server : whatsapp Command : C:\Program Files\nodejs\node.exe Script : C:\Users\You\WhatsApp-MCP-Local\src\index.ts 📋 Next steps: 1. Fully quit Claude Desktop (system tray → Quit) 2. Reopen Claude Desktop 3. Your browser opens at http://localhost:3000 — scan the QR with WhatsApp 4. Done! Use whatsapp_status in Claude to confirm.

- Quit and reopen Claude Desktop
- Browser auto-opens athttp://localhost:3000— scan the QR
- Wait a few minutes for history to sync

whatsapp_status → 📦 1,240 messages stored across 108 chats → 📅 History goes back to: 25/05/2025

WhatsApp only sends recent history during initial sync. To get older messages:
- Open the chat in WhatsApp
- Tap⋮ → More → Export Chat
- ChooseWithout Media
- Send the.txtfile to your computer

First find the contact's JID usingwhatsapp_find_contact "Their Name"in Claude, then:

npm run import -- "C:/path/to/WhatsApp Chat with John Doe.txt" "923001234567@s.whatsapp.net" "John Doe"

✅ Import complete! Contact : John Doe Messages : 1,847 imported Range : 15/03/2023 → 17/05/2026 📦 Database now has 3,091 messages across 109 chats

Messages are de-duplicated automatically — safe to run multiple times.

~/.whatsapp-mcp/ session/ ← WhatsApp auth keys (never shared) creds.json pre-key-*.json whatsapp.db ← All messages, searchable forever

To unlink from WhatsApp:Phone → Settings → Linked Devices → find WhatsApp MCP → Log Out. Then delete~/.whatsapp-mcp/session/and restart Claude Desktop — you'll get a new QR.

To fully remove:Delete~/.whatsapp-mcp/and remove themcpServersblock from the config.

"Server disconnected" error on Windows:Make sure you usedtsx.cmd(nottsx) in the config and paths use/not\.

Browser doesn't open automatically:Visithttp://localhost:3000manually.

Chats show as numbers instead of names:Normal on first connect — names load as WhatsApp syncs contacts. Wait 30 seconds and check again.

Contact not found:Usewhatsapp_find_contact "name"— if it shows "no messages synced yet", export the chat and use the importer.

Manage your WhatsApp, SMS and Phone Calls using a single MCP connector

Send SMS, WhatsApp, and RCS messages programmatically with DLT compliance. Manage contacts, schedule campaigns, and track delivery reports.

Remote MCP server for managing WhatsApp and Telegram AI assistants: projects, prompts, conversations, leads and analytics, with no destructive tools by design.

143 local tools for Claude, Cursor & ChatGPT — Mail, iMessage, Teams, Slack, WhatsApp & files. 100% local, no API keys.

An MCP server for Claude that integrates with the Evolution API for WhatsApp automation.

Create AI-generated memes and convert them into stickers for Telegram and WhatsApp.

Local MCP server for a personal WhatsApp account. Single Go binary wrapping whatsmeow. Adds LID resolution, sent-message storage, disappearing-message timers, targeted history sync. Personal-use; Meta ToS applies.

An MCP server integrating WhatsApp messaging and ElevenLabs AI voice capabilities into VS Code.

WhatsApp automation platform with 120+ MCP tools for AI chatbots, broadcasts, campaigns, contact management, knowledge bases, and newsletters

Salesforce MCP Server - Enhanced Edition