About WhatsApp Connect
WhatsApp Connect is an MCP server published by idle-sync in the Search category: read, search, and send personal WhatsApp messages from any MCP client, behind a send-confirm gate.
The repository has 2 stars and 0 forks, with the last commit a month ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
git clone https://github.com/idle-sync/whatsapp-connect-mcpThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (15)
doctorRuns the diagnostics described in [Diagnostics](#diagnostics) as an MCP tool.
Parameters not published.
download_mediaDownloads attached media to the local data directory — one message, a batch of message ids, or everything in a time window (same window/date/tz forms as `list_messages`, optionally filtered by kind).
Parameters not published.
fetch_older_messagesAsks the phone for messages from before the oldest one stored in a chat, widening how far back it can be read. Call repeatedly to page further back.
Parameters not published.
get_blocklistThe JIDs the account has blocked, fetched live.
Parameters not published.
get_call_historyCalls, newest first, optionally filtered to one peer and time-bounded with the same window/date/tz forms as `list_messages`.
Parameters not published.
get_chatOne chat by JID.
Parameters not published.
get_group_infoA group's subject, description, owner, and admins, fetched live.
Parameters not published.
get_last_interactionThe most recent message involving a JID.
Parameters not published.
get_message_contextThe messages immediately before/after one target message.
Parameters not published.
list_chatsChats (1:1 and group), newest activity first; filterable by name and archived state.
Parameters not published.
Show all 15 tools
list_group_participantsA group's member JIDs, fetched live.
Parameters not published.
list_messagesMessages in a chat, newest first, optionally time-bounded — pass a named window (`today`, `yesterday`, `last_24h`, `last_7d`) or a `date` with an IANA `tz`, or explicit bounds (Unix seconds, RFC 3339, or a bare date); the server does the timezone arithmetic.
Parameters not published.
poll_new_messagesNew messages after a cursor, oldest first — `tail: N` returns the newest N immediately, and a timeout blocks up to 240s until one arrives, so an agent can react to activity without re-reading chats. Own sends excluded unless asked for. Read-only; reacting still goes through the send gate.
Parameters not published.
search_contactsContacts by name or phone number substring.
Parameters not published.
search_messagesFull-text search over message bodies, chat-scoped or global.
Parameters not published.
Ask AI
Ask AI about WhatsApp Connect
Powered by Claude · Grounded in docs
Security checks
6 checks have not been run yet.