Niches · Contacts & address books
Find someone's email or number
No company's docs show a full fit yet. The listings below do the job with a limit, or not at all.
What counts as done
One search call with a read-only scope returns matching people with names, emails and phone numbers, covering saved contacts and, where the API has them, auto-saved or directory people with the source marked; a phone number matches whether given in E.164 or local notation.
Measured, for our own tests: the first search of a session returns results without a separate warm-up failure. No docs we read state these figures, so they don't count against a listing here.
How agents ask for it: what's Sam's email
, who is calling from this number
, find the CTO at Acme in my contacts
, add Priya to the invite
Does the job, with a limit 3
It does the job, but something in the docs or a user's account will get in an agent's way. The limit is named in each row.
| Listing | Why |
|---|---|
| ContactsPlus E Contacts Plus LLC | contacts.search takes full text or field criteria with AND and OR (company:Acme AND title:CTO) under contacts.read, across the Google, iCloud and Outlook books synced into ContactsPlus. The docs do not say whether results mark their source account or how phone formats match. source |
| Google People API B Google LLC | searchContacts works with contacts.readonly and matches names, emails, phones and organisations by prefix, up to 30 results, but needs a warm-up empty query first (acc-04 got FAILED_PRECONDITION), Other contacts and the directory are separate calls, and acc-02 found E.164 numbers unmatched. source |
| Microsoft Graph People and Contacts API C Microsoft Corporation | /me/people with $search does fuzzy matching across contacts and colleagues ranked by relevance with People.Read, and /me/contacts filters saved contacts by email address only. Results are not marked by source in the docs read, phone-format matching is undocumented, and acc-05 got the user and distribution lists back. source |
What stops agents finishing
- search refused with a scope the docs say is enough
- cold cache error on first search
- only a full listing, paged at large token cost
Around it
Before: email.draft, scheduling.create-event. After: email.send, messaging.send-sms, scheduling.add-guest.
Where this comes from
Weight 34 of 100 in Contacts & address books: 6 accounts (acc-01 to acc-06); the commonest reason builders add contacts to an agent
The same as data: /api/v1/use-cases/contacts.look-up-person.json, or the MCP tool get_use_case with id contacts.look-up-person. Other jobs in this category: /api/v1/niches?category=contacts.
For companies
Do agents find, use and choose your tools?
An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.