upsert_contact
Create or update a Google Contact by matching email, phone, or exact name; existing contacts are merged, otherwise a new contact is added.
Instructions
Smart add-or-edit Google Contact. Searches for an existing contact by email, phone number, or exact full name; if found, merges/updates the contact, otherwise creates a new contact. Ideal when adding or editing contacts extracted from PNG/JPG images, text, or markup in Claude, ChatGPT, or Gemini.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "upsert_contact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| urls | No | Website or profile URLs (strings or { value, type }) | |
| merge | No | When updating an existing contact, merge emails/phones/notes instead of overwriting all fields (default: true) | |
| notes | No | Biography or notes about the contact | |
| emails | No | Email addresses (strings or { value, type: 'work'|'home'|'other' }) | |
| phones | No | Phone numbers (strings or { value, type: 'mobile'|'work'|'home'|'other' }) | |
| prefix | No | Honorific prefix (e.g. Dr., Mr., Ms.) | |
| suffix | No | Honorific suffix (e.g. Jr., III, PhD) | |
| birthday | No | Birthday in YYYY-MM-DD or MM-DD format | |
| fullName | No | Full display name (automatically split if givenName/familyName are omitted) | |
| jobTitle | No | Job title or role | |
| nickname | No | Nickname | |
| addresses | No | Physical addresses (strings or structured address objects) | |
| givenName | No | First / given name | |
| photoPath | No | Optional local file path to a PNG/JPG photo to set as the contact's avatar | |
| department | No | Department within the organization | |
| familyName | No | Last / family name | |
| middleName | No | Middle name | |
| photoBase64 | No | Optional base64-encoded PNG/JPG photo to set as the contact's avatar | |
| customFields | No | Custom key-value pairs stored on the contact | |
| organization | No | Company or organization name | |
| resourceName | No | Optional known Google Contact resourceName (e.g. 'people/c12345') | |
| groupResourceNames | No | Contact group resource names (e.g. ['contactGroups/myContacts']) |