Update contact
update_contactEdit a stored contact by ID, changing only named fields while preserving the rest. Add or remove emails, phones, addresses, and roles, or set the preferred email without resending the record.
Instructions
Edit a stored contact by id, changing only the fields you name — everything else is kept, so you never have to read the record and re-send it. Set name, organization, birthday or note directly ("" clears all but the name); add or remove email addresses, phone numbers, postal addresses and roles with the added…/removed… lists; a role is what the person is to the user ("lawyer"), recorded only when the user said or confirmed it, and search_contacts then finds them by it; correct one component of a stored postal address with updatedPostalAddresses; mark the address mail should go to with preferredEmail. Find the contact_id and the [a0]-style handles with search_contacts. To fold two contacts that are the same person into one, use merge_contacts instead.
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": {
"contactId": "<contactId>"
},
"name": "update_contact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | New display name. Omit to keep the stored one. | |
| note | No | New note, replacing every note stored on the contact; `""` clears them. Omit to keep them. (A contact edited elsewhere can carry more than one.) | |
| birthday | No | New birthday as `YYYY-MM-DD`, or `--MM-DD` when the year is unknown; `""` clears it. Omit to keep it. | |
| contactId | Yes | The contact id, as printed by search_contacts under `contact_id`. | |
| addedRoles | No | Roles to add: what the person is to the user ("lawyer"), as the user said or confirmed it. Never inferred from mail. | |
| addedEmails | No | Email addresses to add to the contact. | |
| addedPhones | No | Phone numbers to add to the contact. | |
| organization | No | New organization; `""` clears it. Omit to keep the stored one. | |
| removedRoles | No | Roles to remove (case-insensitive). | |
| removedEmails | No | Email addresses to remove (case-insensitive). | |
| removedPhones | No | Phone numbers to remove, each given either as its `[p0]` handle or as the number itself. | |
| preferredEmail | No | The address mail to this contact should go to: one already on the contact or added in this call. search_contacts then ranks it first. Omit to keep the current one. | |
| addedPostalAddresses | No | Postal addresses to add. | |
| removedPostalAddresses | No | Postal addresses to remove, each given either as its `[a0]` handle or as its label (`home`, `work`). | |
| updatedPostalAddresses | No | Corrections to stored postal addresses: name the handle plus only the components that change. |