Skip to content

Tool

search_contacts

Search contacts

Read-onlyIdempotent
SurfacesChat agentMCPCLI

Find people the user corresponds with — by name or email prefix. Use to resolve a recipient before drafting/sending, or to look someone up. Returns matching contacts (recent correspondents first).

CLI: tinbox search-contacts

Parameters

NameTypeRequiredDescription
querystringnoName or email prefix to match. Omit for the most recent correspondents.
limitnumbernoMax contacts to return (default 8).