manage_contacts
Search, read, create, update, and delete Google Contacts, including saved contacts, past correspondents, and your organization's directory.
Instructions
Search, read, create, update and delete Google Contacts: your saved contacts, the addresses you have corresponded with but never saved, and your organization's directory.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Full name, e.g. `Ada Lovelace`. Split into given and family name on the way in; a single word becomes the given name. | |
| Yes | Account email address. On list operations, "all" runs it once for every configured account. | ||
| notes | No | Free-text note stored on the contact | |
| phone | No | Phone number, in whatever form you have it — Google normalizes it. On `update` this REPLACES every number the contact has — pass an empty string to clear them. | |
| query | No | Text to match against names, email addresses, nicknames and phone numbers. Matching is by PREFIX: `ann` finds Anna, `nna` finds nobody. | |
| company | No | Organization name | |
| jobTitle | No | Job title within the organization | |
| contactId | No | Person id as `list` or `search` printed it (e.g. `people/c1234567890`). A bare id without the `people/` prefix is accepted. | |
| operation | Yes | list: list your saved contacts | search: search your saved contacts by name, email, nickname or phone | get: get one person in full — addresses, birthday, notes, relations | create: create a new contact | update: change an existing contact (only the fields you pass; pass an empty string to clear one) | delete: delete a contact | listOther: list 'other contacts' — addresses you have corresponded with but never saved | searchOther: search 'other contacts' by name or email | listDirectory: list people in your organization's directory (Workspace accounts only) | searchDirectory: search your organization's directory by name or email (Workspace accounts only) | |
| pageToken | No | Continue from where a previous page stopped — pass the token that response printed | |
| sortOrder | No | Order for `list` — by first name, by last name, or most recently changed first | |
| maxResults | No | Max people to return (default 25). Capped per operation: 30 for `search` and `searchOther`, 100 for everything else. | |
| contactEmail | No | The contact's email address. (`email` is the account making the call, not the person being saved.) On `update` this REPLACES every address the contact has — pass an empty string to clear them. |