dusk botlook up a gmail contact before choosing an address
you remember the photographer, just not where you put their address. give the bot a name, nickname, email, phone clue or company.
it searches saved google contacts and, if you ask, people you contacted without saving. get names and possible addresses in chat, then choose the person you recognise. the broader search returns fewer details.
search people, in plain words
get the address without digging through old email. a surname, phone fragment or company gives the bot somewhere to start. the lookup leaves contacts unchanged and writes no email.
saved contacts can return company details. including unsaved contacts limits results to names, email addresses and phone numbers. need the company too? ask for a separate saved-contact search.
a routine to copy
paste this into a chat with your bot
every thursday at 1, read visitor names for the coming week from the visitor-list file in the project folder.
- search my work gmail saved contacts for each name
- include unsaved contacts only when saved contacts have no match
- show names and possible email addresses here
- flag namesakes and say which searches finished
never choose between uncertain matches, edit contacts or message anyone.- when
- thursdays at 13:00
- needs
- gmail connected with read only and contact-reading access; the visitor-list file in the project folder
what comes back looks like this (an example)
visitor addresses
leila patel: one saved contact, [email protected].
second visitor: two possible matches; surname needed to choose.
unsaved-contact search finished for names without a saved match.good jobs for it
- recover a booking contact. search for the photographer whose surname you remember.
- find a repair number. look up the equipment contact you saved.
- place a visitor before they arrive. match saved contacts to the firm on your visitor list.
- recover an unsaved address. include people you emailed without adding to contacts.
before it runs
dusk bot counts Search People as a read: it looks and changes nothing. a bot you allow only to read can use it.
the permissions Gmail asks for to run it: contacts, contacts.readonly, contacts.other.readonly.
how to start
- connect the right address book. choose the google account holding your contacts and keep this bot read only.
- try someone you know. ask for their name and address, then compare them with your address book.
- choose the search scope. say whether it may include unsaved contacts.
- give it the visitor file. open automations, confirm thursday at 13:00 and read the first report.
limits worth knowing
- 30 matches is the ceiling. add a surname or company clue when a common name fills the list.
- one search can fail while the other succeeds. ask which contact sources finished.
- unsaved contacts return fewer details. search saved contacts separately for company information.
the details it works from
| input | required | what it is |
|---|---|---|
query | yes | Matches contact names, nicknames, email addresses, phone numbers, and organization fields. |
page_size | no | Maximum results to return; values >30 are capped to 30 by the API. |
person_fields | no | Comma-separated fields to return (e.g., 'names,emailAddresses'). |
other_contacts | no | When True, searches both saved contacts and 'Other Contacts' (people you've interacted with but not explicitly saved). |
from composio's catalog for Gmail (action GMAIL_SEARCH_PEOPLE, read 12 november 20264). your bot fills these in from what you tell it.
try it in 2 minutes
- connect the google account that holds your contacts
- ask for a person by surname or company
- request names and possible addresses only
- compare the address and company with the person you know
mistakes people make
trusting the first namesake
compare the address and company. let the bot show uncertain matches.
asking for company details in the broad search
run a saved-contact search separately; unsaved-contact results omit that detail.
questions
can it find someone i never saved?
yes, ask it to include unsaved contacts. these are people you interacted with, rather than entries you saved.
can i search by company?
yes, search your saved contacts for the company. those results can return its name too. the broader unsaved-contact search leaves company details out.
does looking someone up add them to contacts?
no, the lookup only reads. your address book stays as it was.
sources
read next
find gmail messages from a half-remembered detailthe message behind the detail you remember.
a gmail assistant that sorts, drafts and briefs youwhat a bot can really do in your inbox.
claude code for email: clean up one slice firstfind the mail you will need next month.
apply one gmail filing decision to a batch of messagesfile the notices. keep the customer replies.
draft gmail replies with ai, then send them yourselfreplies in your drafts, sent by you.
permanently delete one gmail conversation with aipermanent means every message in it.
drafted with ai help from the dusk bot docs and the sources listed on this page, then checked against them. if something here is wrong or out of date, write to [email protected].