update_contact
Modify a contact by sending only fields to change; add or remove emails and phones, replace addresses, and get previous values to undo edits.
Instructions
Change a contact. Send only the fields to change. Text fields replace the old value, and an empty string clears them. Emails and phones change with 'add_emails', 'remove_emails', 'add_phones' and 'remove_phones' (remove by value). 'addresses' replaces all addresses, and [] removes them. The result has 'previous' with the old values of the fields you sent, so you can undo the change. Notes are not supported. macOS refuses to change a contact that has a note, unless the app has a special Apple entitlement. Then the tool returns an error and nothing changes.
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": {
"id": "<id>"
},
"name": "update_contact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Contact id from search_contacts. Use it as given. | |
| birthday | No | New birthday. Date as 2026-11-12, or --11-12 when the year is not known. Empty string clears it. | |
| addresses | No | List of postal addresses. Each has at least one of street, city, state, postal_code, country. | |
| job_title | No | New job title. Empty string clears it. | |
| add_emails | No | List of {label, value} objects with the email address to add. | |
| add_phones | No | List of {label, value} objects with the phone number to add. | |
| given_name | No | New first name. Empty string clears it. | |
| family_name | No | New last name. Empty string clears it. | |
| organization | No | New organization. Empty string clears it. | |
| remove_emails | No | Email addresses to remove (ignores case). | |
| remove_phones | No | Phone numbers to remove. Spaces and dashes do not matter. |