search_contacts

MCP tool from Whatsapp MCP Stream by loglux

Search contacts by name or phone number.

How to use it

search_contacts is exposed by the Whatsapp MCP Stream MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the search_contacts tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.

FULL WHATSAPP MCP STREAM LISTING

Other tools in Whatsapp MCP Stream (26)

analyze_group_overlaps

Find members that appear across multiple groups.

check_auth_status

Check if the WhatsApp client is authenticated and ready.

download_media

Download media from a message.

find_members_not_in_contacts

Find group members missing from contacts.

find_members_without_direct_chat

Find group members with no direct chat.

get_chat_by_contact

Resolve a contact by name or phone number and return chat metadata.

get_chat_by_id

Get chat metadata by JID.

get_contact_by_id

Get contact details by JID.

get_direct_chat_by_contact_number

Resolve a direct chat JID by phone number.

get_group_info

Get group metadata and participants by group JID.

get_last_interaction

Get the most recent message for a JID.

get_message_by_id

Get a specific message by ID (jid:id).

get_message_context

Get recent messages around a specific message.

get_profile_pic

Get profile picture URL for a JID.

get_qr_code

Get the latest WhatsApp QR code as an image for authentication.

list_chats

List chats with metadata and optional last message.

list_groups

List group chats only.

list_messages

Get messages from a specific chat.

logout

Logout from WhatsApp and clear the current session.

ping

Health check tool.

resolve_contact

Resolve a contact by name or phone number (best matches).

run_group_audit

Run combined group audit as one routine operation.

search_messages

Search messages by text (optionally scoped to a chat).

send_media

Send media (image/video/document/audio). Accepts mediapath, mediaurl, or mediacontent (base64). Supports optional idempotencykey.

send_message

Send a text message to a person or group. Supports optional idempotencykey.

stage_media

Save a file to the server's media directory and return its local path. Use the returned savedpath in sendmedia (mediapath) — avoids base64 when the source is a URL (server downloads directly), or allows sending the same file to multiple recipients without re-uploading.