Merge contacts
merge_contactsCombine duplicate contacts into one kept record, delete the rest, and consolidate emails, phones, addresses, notes, and interaction history; conflicting values are listed for review.
Instructions
Merge duplicate contacts — the same person or organization collected under several addresses — into the one to keep, and delete the others. The kept contact gains every email address, phone number, postal address and note of the merged ones and their interaction history; its name, organization, birthday and preferred address stay unless it has none, and every value that does not fit is listed as a conflict. Later mail from any merged address updates the kept contact. Returns the merged contact in the detailed search_contacts format plus the full details of the removed contacts, which is what undoing it by hand needs. Find the ids with search_contacts; to move a single address between two contacts that are different people, use update_contact instead, and to drop a contact without keeping anything, delete_contact.
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>",
"mergeContactIds": "<mergeContactIds>"
},
"name": "merge_contacts"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| contactId | Yes | The contact to keep, as printed by search_contacts under `contact_id`. Its name, organization and birthday win. | |
| preferredEmail | No | The address mail to this contact should go to, from any of the merged contacts. Omit it to keep the preferred address the kept contact has now. | |
| mergeContactIds | Yes | The contacts to fold into it and then delete, as printed by search_contacts under `contact_id`. Up to 10. |