Get many contacts at once
batch_get_contactsRetrieve up to 200 contacts at once with per-entry status and original ordering. Avoids quota-heavy individual lookups and handles missing contacts gracefully without failing the whole batch.
Instructions
Fetches up to 200 contacts in one call (People API people:batchGet) — far cheaper against the tight per-user quota than a get_contact loop. Returns responses[], one per requested resource name IN THE SAME ORDER, each { requestedResourceName, status, person }; a missing contact gets a NOT_FOUND status in its own entry instead of failing the whole call, so check per-entry status. person_fields works exactly like in get_contact.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"resource_names": "<resource_names>"
},
"name": "batch_get_contacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| person_fields | No | Person fields to return (default names, emailAddresses, phoneNumbers, organizations, memberships). Only masked fields come back — an absent field may be unmasked, not empty. | |
| resource_names | Yes | The contacts to fetch (1..200 people/<id> resource names). |