How to Find Contacts and People

Find people across your personal contacts, company directory, and recent email history using two different search tools.

Search by Relevance (People API)

The search-people tool searches broadly — your contacts, organisational directory, and people you’ve recently communicated with:

“Find Sarah from marketing”

tool: search-people
params:
  query: "Sarah"

“Who do I know at Contoso?”

tool: search-people
params:
  query: "Contoso"
  count: 10

Results are ranked by relevance — people you interact with frequently appear first.

Search Your Contact Book

The manage-contact tool searches only your personal contacts:

“Search my contacts for John Smith”

tool: manage-contact
params:
  action: "search"
  query: "john smith"

List All Contacts

“Show me all my contacts”

tool: manage-contact
params:
  action: "list"

Control the number returned:

tool: manage-contact
params:
  action: "list"
  count: 100

Which Tool Should I Use?

Tool	Searches	Best for
search-people	Contacts + directory + recent emails	Finding anyone you’ve interacted with
manage-contact (search)	Personal contacts only	Looking up saved contact details

Use search-people when you’re not sure where the person is — it casts a wider net. Use manage-contact when you know the person is in your contact book and want their full details.

Tips

• search-people is read-only and auto-approved — fast for quick lookups
• People API results include job titles and departments from your organisation’s directory
• For managing contacts (create, update, delete), see Manage Contacts

Related

• Manage Contacts — create, update, and delete contacts
• Find Emails — search emails from a specific person
• Tools Reference — search-people