# Find someone's email or number

> Find someone's email or number: 0 companies fully do it, 3 with a limit, 3 carry the tag. Every listing in Contacts & address books with the reason and a source.

- Canonical: https://www.anchorterminal.com/niches/contacts.look-up-person/
- Markdown: https://www.anchorterminal.com/niches/contacts.look-up-person/index.md (~850 tokens)
- Slim: https://www.anchorterminal.com/niches/contacts.look-up-person/index.min.md (~280 tokens, same facts, less prose, for token-sensitive contexts)
- JSON: https://www.anchorterminal.com/niches/contacts.look-up-person/index.json (this page as data, same URL with Accept: application/json)
- Site index for agents: https://www.anchorterminal.com/llms.txt (the key docs and every listing in one file, at most 16 MB, about 4 million tokens: https://www.anchorterminal.com/llms-full.txt)
- API: https://www.anchorterminal.com/api/v1/index.json
- MCP: https://www.anchorterminal.com/mcp (the whole catalogue as tools, no key)
- DNS: dig +short TXT <slug>.grade.anchorterminal.com (the grade as a DNS TXT record, for a sandbox with no HTTP where names still resolve; also top., best.<category>. and <a>.vs.<b>. under the zone, and the same under grade.letme.dev)
- Licence: CC BY 4.0, credit Anchor Terminal and link this page (https://www.anchorterminal.com/terms/#data)
- Updated: 2026-11-15

No company's docs show a full fit yet. The listings below do the job with a limit, or not at all.

| Companies, full fit | With a limit | Carry the tag | Share of the category's work | First-hand accounts |
| --- | --- | --- | --- | --- |
| 0 | 3 | 3 | 34 | 6 |

## 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.

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

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.

- **ContactsPlus (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.
- **Google People API (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.
- **Microsoft Graph People and Contacts API (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.

## 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

As data: https://www.anchorterminal.com/api/v1/use-cases/contacts.look-up-person.json, or the MCP tool get_use_case with id contacts.look-up-person. Draft, read 2026-11-15 from public docs and first-hand accounts, not yet reviewed by a person.

---

Query this catalogue directly over MCP: https://www.anchorterminal.com/mcp (Streamable HTTP, no key). How: https://www.anchorterminal.com/agents/#mcp
