WhatsApp MCP Server by lharries: Setup for Claude, Cursor and Other Apps

• Finds contacts by name or phone number

  Looks up people in your WhatsApp contacts by name or number and returns their identifiers (JIDs) for use in other requests.

  Try: “Find the contact for Maria Lopez.”

  Read · search_contacts

• Searches your messages by text, sender, chat or date

  Returns messages that match any mix of text, sender number, chat, and a before or after date. It can also return the messages around each match, 20 per page by default.

  Try: “Find messages in the Family group from last week that mention dinner.”

  Read · list_messages

• Lists your chats, optionally filtered by name

  Returns your chats with details such as the latest message. You can filter by name and page through results.

  Try: “Show my 10 most recent chats.”

  Read · list_chats

• Shows details for one chat

  Returns the details of a single chat for an ID you give it, with its last message if you want it.

  Try: “Show me details for the chat with the ID I just found.”

  Read · get_chat

• Finds your one-to-one chat with a phone number

  Looks up your direct chat with the person who has a given phone number.

  Try: “Find my direct chat with 15551234567.”

  Read · get_direct_chat_by_contact

• Lists every chat a contact is part of

  Returns all chats that include a given contact, including groups, with paging.

  Try: “Which chats is Sam in?”

  Read · get_contact_chats

• Shows the latest message with a contact

  Returns the most recent message that involves a given contact.

  Try: “What was the last thing Sam and I talked about?”

  Read · get_last_interaction

• Shows the messages around one message

  Returns the messages sent just before and after a message you point to, so you can follow the conversation.

  Try: “Show me what was said around that message.”

  Read · get_message_context

• Sends a WhatsApp message to a person or group

  Sends a text message from your WhatsApp account to a phone number or group ID. The message goes out right away.

  Try: “Send "Running 10 minutes late" to Maria.”

  Write · send_message

• Sends a picture, video, document or audio file

  Reads a file from a path on your computer and sends it to a person or group from your account.

  Try: “Send ~/Documents/menu.pdf to the Family group.”

  Write · send_file

• Sends an audio file as a voice message

  Sends a file from your computer as a playable voice message. Files that are not .ogg Opus are converted first, which needs FFmpeg.

  Try: “Send ~/voice-note.mp3 to Sam as a voice message.”

  Write · send_audio_message

• Saves a photo, video, audio or document from a message

  Downloads the media attached to a message and saves it on your computer under the bridge folder, then returns the file path.

  Try: “Download the photo from that message.”

  Write · download_media

Watch out for

• Message text can steer the assistant

  The README warns about prompt injection with private data. Do not let it send messages or files without your approval. github.com

• The bridge API is open to your whole network, without a login

  The bridge starts its REST API with ListenAndServe on ":8080", which binds every network interface, and checks no credentials. Another device on your Wi-Fi or LAN can call /api/send to message anyone as you, including attaching any file path on your computer. Block port 8080 with a firewall. github.com

• It sends messages as you

  Messages and files go out from your own account the moment the tool runs. Check the recipient before you approve. github.com

• send_file reads any path you give it

  The send tools take a file path on your computer and upload that file to WhatsApp. Check the path and the recipient. github.com

• Uses your personal account, not the business API

  It signs in as you through the WhatsApp web multi-device API, with an unofficial library. Treat it as access to your whole account. github.com

Security advisories