List WhatsApp Contacts (people + groups)
whatsapp_list_contactsLists WhatsApp contacts (people and groups) with IDs, names, and activity stats. Use returned IDs as contactId for sending messages or reading chats.
Instructions
Unified address book — lists people you DM and groups you're in.
Use the returned 'id' as contactId in any chat-targeting tool (send_text, read_messages, etc.):
Person: id = phone digits (universal — survives @c.us↔@lid flips)
Group: id = group JID (e.g. "120363...@g.us")
Args:
kind: "person" | "group" | "all" (default "all")
search: Filter by name or id (optional)
limit: Maximum rows to return (1-100, default 20)
offset: Pagination offset for the persons section (default 0)
Returns array of contacts with:
kind: "person" | "group"
id: phone digits or group JID — pass to other tools
name: display name (Google Contact name → push name → phone/jid fallback)
messageCount, lastMessageAt: activity stats
For persons: pushName, googleName, email, organization
For groups: memberCount
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | No | Filter by contact type (default 'all') | all |
| search | No | Filter by name or id (optional) | |
| limit | No | Maximum rows to return (1-100, default 20) | |
| offset | No | Pagination offset (default 0) |