search_contacts

MCP tool from Whatsapp MCP by verygoodplugins

Search contacts by name or phone number.

How to use it

Project documentation lists search_contacts for the Whatsapp MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.

Install Whatsapp MCP

$uv pip install -e ".[dev]"
FULL WHATSAPP MCP LISTING

Other tools in Whatsapp MCP (14)

download_media

Download media from a received message.

get_chat

Get specific chat metadata by JID.

get_contact

Resolve a WhatsApp contact name from a phone number, LID, or full JID.

get_contact_chats

List all chats involving a specific contact.

get_direct_chat_by_contact

Find a direct message chat with a contact.

get_last_interaction

Get the last message exchanged with a contact.

get_message_context

Get messages around a specific message for context.

list_chats

List all chats with metadata.

list_messages

Get messages with filters, date ranges, and sorting.

mark_messages_read

Mark one or more messages from the same chat and sender as read. This explicitly

send_audio_message

Send a voice message (automatically converts to Opus .ogg format).

send_file

Send a media file (image, video, document).

send_message

Send a text message to a contact or group, optionally as a quoted reply.

send_reaction

Send (or remove) an emoji reaction to a message.