Skip to main content
The WhatsApp MCP server exposes these tools.

Connection and pairing

ToolDescription
whatsapp_statusGet connection, pairing, and connector status.
whatsapp_request_pairStart WhatsApp pairing and return the pairing request result.
whatsapp_pair_statusRead the current pairing status and QR payload.
whatsapp_unlinkUnlink the paired WhatsApp device and clear local WhatsApp state.

Sync and read

ToolRequired argumentsDescription
whatsapp_syncNoneRead changed conversations, contacts, and messages after a sync cursor. Optional cursor and limit.
whatsapp_list_messagesconversation_idList messages in a WhatsApp conversation. Optional before_message_id and limit.
whatsapp_download_mediamessage_idDownload media for a message as base64 plus MIME metadata.

Messages

ToolRequired argumentsDescription
whatsapp_send_messagetext plus conversation_id or contact_idSend a WhatsApp text message.
whatsapp_react_to_messagemessage_id plus conversation_id or toReact to a message. Empty emoji clears the reaction.
whatsapp_edit_messagemessage_id, text, plus conversation_id or toEdit a sent message.
whatsapp_delete_messagemessage_id plus conversation_id or toDelete or revoke a sent message.
whatsapp_mark_readmessage_ids plus conversation_id or toMark messages as read.

Groups and commands

ToolRequired argumentsDescription
whatsapp_create_groupname, participantsCreate a WhatsApp group. Optional announce and locked.
whatsapp_update_group_participantsgroup_jid, participants, actionAdd, remove, promote, or demote group participants.
whatsapp_enqueue_commandkindQueue a raw WhatsApp command.
whatsapp_command_statuscommand_idRead queued command status and result.

Example tool request

{
  "name": "whatsapp_send_message",
  "arguments": {
    "contact_id": "14155550123@s.whatsapp.net",
    "text": "Hello from an MCP client"
  }
}
Tool availability depends on the OAuth grant scopes and the selected connection.