whatsapp_statusLABSCO SUMMARY
Years of WhatsApp, searchable, without any of it leaving your machine.
The archive is the point: a local copy of your history turns "when did we agree that" into a search rather than an hour of scrolling, and the send tool means you can answer in the same breath.
What it is
A local WhatsApp bridge. You link it once by scanning a QR code, and it keeps your chats in a SQLite database at ~/.whatsapp-mcp/whatsapp.db, with the auth keys in ~/.whatsapp-mcp/session/ and nothing sent anywhere else.
What you get
- Full-text search across your complete chat history, not just what is loaded on screen
- Every chat listed by recency, and group chats listed on their own
- Messages read back from a chat you name
- A contact found by name when you are not sure which chat it is
- Messages sent from wherever you are already working
- A status read that reports the connection plus how many messages are stored, across how many chats, and how far back the history goes
Requirements
Node.js v20+ and Git. Windows has a double-click installer; macOS and Linux use make install. Linking is a QR scan on a local page after Claude Desktop restarts, and the first sync takes a few minutes. Older conversations can be brought in through WhatsApp's own Export Chat.
Setup effort
Build from source — git clone https://github.com/khetsinghrajput/WhatsApp-MCP-Local.git
USE CASES
01
Finding the message where something was agreed
Search the full history for the phrasing you half-remember, then read the messages around it in that chat.
02
Replying without switching apps
Find the contact, read the last exchange, send the reply — from wherever you were already working.
03
Working out what still needs answering
List chats by recency and read the tail of each — the pass you make after being away for a day.
04
Summarising what a group has been up to
List the groups, pick one, and pull its recent messages for a summary instead of reading four hundred of them.
05
Checking the sync has actually finished
The status read gives the stored message count, the chat count and the earliest date held — enough to know whether a search covered the period you meant.
7 tools
Listed in project docs. Your client may show a different list.
whatsapp_list_chatswhatsapp_list_groupswhatsapp_find_contactwhatsapp_get_messageswhatsapp_send_messagewhatsapp_search_messagesBEFORE YOU INSTALL
What to know first
Tools you get
7 tools named in the project's documentation.
Requires
Node.js v20 or later
INSTALLATION
Connect your client
This one is built from source rather than installed with a single command.
Server setup
TERMINAL
git clone https://github.com/khetsinghrajput/WhatsApp-MCP-Local.git
cd WhatsApp-MCP-Local
make install(Windows alternative) Open the cloned folder → double-click install.bat
(no make) chmod +x install.sh && ./install.sh
(manual, any platform) npm install then npm run setup
Fully quit Claude Desktop (system tray → Quit)
Reopen Claude Desktop
Your browser opens at http://localhost:3000 — scan the QR with WhatsApp
