manage_contacts_batch
Batch create, update, or delete contacts in Google Workspace. Consolidates multiple batch operations into one tool for efficient contact management.
Instructions
Batch create, update, or delete contacts. Consolidated tool replacing batch_create_contacts, batch_update_contacts, and batch_delete_contacts.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| user_google_email | Yes | The user's Google email address. Required. | |
| action | Yes | The action to perform: "create", "update", or "delete". | |
| contacts | No | List of contact dicts for "create" action. Each dict may contain: given_name, family_name, phones, emails, organizations, notes, address. Deprecated: phone, email, organization, job_title. | |
| updates | No | List of update dicts for "update" action. Each dict must contain contact_id and may contain the same fields as contacts. | |
| contact_ids | No | List of contact IDs for "delete" action. | |
| field | No | For "update" action — the single People API field to update across all contacts in this batch. Required. Must be one of: names, phoneNumbers, emailAddresses, organizations, biographies, addresses. Using a single field per batch call prevents unintentional data loss from a union updateMask overwriting unrelated fields. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |