Find contacts in Gmail - search for specific people or email addresses from email history.
Optimized custom tool for contact lookup from real Gmail message history.
Use this first for contact search.
Parameters:
query (required): name, email, or domainmax_results (optional, default: 30): number of messages to scanBest query patterns:
john (name)[email protected] (exact email)company.com (domain)@ (broad sweep for a general contact list)Scaling:
max_results=3060, then 100Searches people/contact records by name, email, phone, and organization.
Best for:
Lists Google contact connections from the account contacts dataset.
Best for:
Search emails directly for context when contact tools are inconclusive.
query="john"query="[email protected]" or query="@company.com"query="company.com"GMAIL_GET_CONTACT_LIST(query="john", max_results=30)
GMAIL_GET_CONTACT_LIST(query="john", max_results=60)
GMAIL_GET_CONTACT_LIST(query="john", max_results=100)
If still empty, retry with alternate token (last name, domain, exact email fragment).
GMAIL_SEARCH_PEOPLE(query="john")GMAIL_GET_CONTACTSGMAIL_FETCH_EMAILS for recent sender/recipient contextShow concise matches (name + email). If multiple strong matches remain, ask one focused question.
Example:
I found 3 likely matches for "john":
1. John Smith - [email protected]
2. John Doe - [email protected]
3. Johnny Lee - [email protected]
Which one should I use?
GMAIL_GET_CONTACT_LIST before other contact tools.max_results.