find_people

Finds people by name or email in your own private Rolodex. Use it to resolve the exact person before reading or changing their notes.

Annotations: readOnlyHint: true · destructiveHint: false · idempotentHint: true · openWorldHint: false

Inputs#

Returns#

{ people, hasMore }. Each identity has personId, nullable contactAuthoredName and ownerAuthoredName, and emails. Exact matches come before prefix and substring matches. Matching ignores case and accents. hasMore means the query needs narrowing. Multiple results remain ambiguous; ask the member rather than choosing for them.

An empty list is a successful result. This tool searches only your own identities and returns no relationship context, notes, or another member’s contacts.

Example#

{
  "query": "Pat",
  "limit": 10
}

Result (synthetic data):

{
  "people": [
    {
      "personId": "00000000-0000-4000-a000-000000000005",
      "contactAuthoredName": "Synthetic Pat",
      "ownerAuthoredName": null,
      "emails": [
        "pat@example.test"
      ]
    }
  ],
  "hasMore": false
}

Related#

See the private notes workflow and errors and limits.