io.github.mcp-dir/whatsapp-mcp

up checked 2026-11-11T07:39:09.240Z

Unclaimed · Unverified

Agent searches it appeared in, last 30 days: 0. Run this server? Claim the listing: verified label, uptime alerts and analytics.

Publisher-provided title

WhatsApp

Publisher-provided description

Connect a personal/Business WhatsApp account via QR pairing (multi-device, like WhatsApp Web). Send

Summary by lookupd

Reads and sends WhatsApp messages, manages groups and contacts, and changes chat state for a paired personal or business account.

Install

Claude Code, remote (streamable-http)

claude mcp add --transport http whatsapp https://api.mcp.ai/p_whatsapp

Codex, remote (streamable-http)

codex mcp add whatsapp --url https://api.mcp.ai/p_whatsapp

Cursor, remote (streamable-http) → .cursor/mcp.json

{
  "mcpServers": {
    "whatsapp": {
      "url": "https://api.mcp.ai/p_whatsapp"
    }
  }
}

Other clients: docs. Or tell your agent: Set up lookupd for me: read https://lookupd.com/agent.md and follow it.

Tools (showing 30 of 47)

Publisher-provided text

• whatsapp_list_accounts List WhatsApp accounts paired to this install — wa_jid, phone, label, proxy on/off, status.
• whatsapp_sync Refresh this account's local data from WhatsApp — pulls recent messages and refreshes the groups/contacts lists into the local store. Call it BEFORE reading (ch
• whatsapp_send_text Send a WhatsApp message (text or media). Actions: - text: { to, text, reply_to? } - media: { to, type ('image'|'video'|'audio'|'document'|'sticker'),
• whatsapp_send_media Send a WhatsApp message (text or media). Actions: - text: { to, text, reply_to? } - media: { to, type ('image'|'video'|'audio'|'document'|'sticker'),
• whatsapp_chats List WhatsApp chats (individual + group). Sorted by most recent activity.
• whatsapp_messages List messages in a chat from LOCAL history. Requires chat_jid (from whatsapp_chats). Paginate backwards by passing the oldest message's timestamp as `before` (I
• whatsapp_messages_write Mark messages as read in a chat. Requires chat_jid. Optional message_id (marks up to this message; omit to mark all unread). Bulk support: accepts message_ids
• whatsapp_contacts_list Read WhatsApp contacts. Actions: - list: search across contacts (query optional — substring on name/phone). Default limit 50. - get: full contact info by JID.
• whatsapp_contacts_get Read WhatsApp contacts. Actions: - list: search across contacts (query optional — substring on name/phone). Default limit 50. - get: full contact info by JID.
• whatsapp_groups List WhatsApp groups the account belongs to — subject, jid, participants count, owner.
• whatsapp_group_members List the members of a WhatsApp group (live). Returns each participant's JID, phone, and admin/super-admin flag. Requires group_jid (…@g.us, from whatsapp_groups
• whatsapp_group_participants_add Manage participants of a WhatsApp group (the connected account must be a group admin). action: 'remove' kicks members, 'promote' makes them admin, 'demote' remo
• whatsapp_group_participants_remove Manage participants of a WhatsApp group (the connected account must be a group admin). action: 'remove' kicks members, 'promote' makes them admin, 'demote' remo
• whatsapp_group_participants_promote Manage participants of a WhatsApp group (the connected account must be a group admin). action: 'remove' kicks members, 'promote' makes them admin, 'demote' remo
• whatsapp_group_participants_demote Manage participants of a WhatsApp group (the connected account must be a group admin). action: 'remove' kicks members, 'promote' makes them admin, 'demote' remo
• whatsapp_react React to a message with an emoji (or remove your reaction by passing an empty emoji). Requires chat_jid + message_id. Bulk support: accepts message_ids for bat
• whatsapp_poll_create Send a poll or vote on one. Actions: - create: { to, name, options[] (2–12), selectable_count? } - vote: { chat_jid, message_id, options[] (the option texts t
• whatsapp_poll_vote Send a poll or vote on one. Actions: - create: { to, name, options[] (2–12), selectable_count? } - vote: { chat_jid, message_id, options[] (the option texts t
• whatsapp_message_delete Manage a message you can act on. Actions: - delete: { chat_jid, message_id, for_everyone? (default true) } — delete for everyone (your msg) or just for you - f
• whatsapp_message_forward Manage a message you can act on. Actions: - delete: { chat_jid, message_id, for_everyone? (default true) } — delete for everyone (your msg) or just for you - f
• whatsapp_message_edit Manage a message you can act on. Actions: - delete: { chat_jid, message_id, for_everyone? (default true) } — delete for everyone (your msg) or just for you - f
• whatsapp_chat_metadata Get metadata for a single chat (subject/name, archived/pinned/muted state, unread count, timestamps). Requires chat_jid.
• whatsapp_chat_archive Change a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: archive]
• whatsapp_chat_unarchive Change a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: unarchive]
• whatsapp_chat_pin Change a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: pin]
• whatsapp_chat_unpin Change a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: unpin]
• whatsapp_chat_mute Change a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: mute]
• whatsapp_chat_unmute Change a chat's state. action: archive/unarchive, pin/unpin, mute/unmute. Requires chat_jid. [Flattened action: unmute]
• whatsapp_group_manage_create Group lifecycle/admin (the connected account must be a group admin for most actions). Actions: - create: { name, participants[] } - leave: { group_ji
• whatsapp_group_manage_leave Group lifecycle/admin (the connected account must be a group admin for most actions). Actions: - create: { name, participants[] } - leave: { group_ji

Details

• Version: 0.1.0
• Transports: streamable-http
• Uptime (7 days): 100%
• Median latency: 136 ms
• First indexed: 2026-11-01T09:40:27.275Z
• Last seen in registry: 2026-11-01T09:40:27.275Z
• Repository: https://github.com/mcp-dir/whatsapp-mcp

Badge for your README

Shows this live status and links here; updates hourly.

[![lookupd status](https://lookupd.com/badge/io.github.mcp-dir/whatsapp-mcp.svg)](https://lookupd.com/servers/io.github.mcp-dir/whatsapp-mcp)

• 62071 servers
• Last crawl: 2026-11-11T16:39:06.253Z
• API base: https://api.lookupd.com
• MCP URL: https://api.lookupd.com/mcp