personal-whatsapp-mcp MCP Server

Self-hosted, open source, and a single process. One phone number, 23 MCP tools, a web UI that looks like WhatsApp Web, and an auto-reply you configure rather than code.

Local server

What is the personal-whatsapp-mcp Server?

personal-whatsapp-mcp is an MCP project maintained in the gnaneshdivi/personal-whatsapp-mcp repository. The maintainer describes its purpose as “Self-hosted, open source, and a single process. One phone number, 23 MCP tools, a web UI that looks like WhatsApp Web, and an auto-reply you…”. Read the project documentation for the complete scope.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
wa_statusWhether WhatsApp is linked, connected, and finished syncing.
wa_pairBegin linking a WhatsApp number, and return the QR payload as text.
wa_logoutUnlink the device and delete everything it collected.
wa_list_chatsList conversations, most recent first, with names and unread counts.
wa_get_messagesRead a conversation, newest first.
wa_searchFull-text search across message history, best matches first.
wa_get_threadMessages surrounding one message — context around a search hit.
wa_unreadUnread count for one chat, or across all chats when chat is empty.
wa_sendSend a text message.
wa_send_mediaSend an image, video, audio, document or sticker.
wa_reactReact to a message. Pass an empty emoji to remove the reaction.
wa_mark_readMark a chat as read, clearing its unread badge.
wa_typingShow or clear the typing indicator in a chat.
wa_profileWhat WhatsApp will tell you about a contact.
wa_check_numberCheck whether a phone number is on WhatsApp before messaging it.
wa_get_reply_settingsCurrent auto-reply configuration, with secrets redacted.
wa_set_reply_settingsChange the auto-reply configuration. Send only what you are changing.
wa_test_replyRun the configured backend against a made-up message WITHOUT sending.
wa_reply_logRecent auto-reply decisions and why each one fired or did not.
wa_delivery_statusDelivery state of your recent messages in a chat: sent, delivered, read.
wa_list_groupsGroups this number is in, with names.
wa_group_infoName, topic and participants of a group.
wa_download_mediaDownload the media attached to a message and return it base64-encoded.