Delete contact
delete_contactDeletes a contact by ID from the account and all syncing devices; use it to remove address-book records, noting header- or calendar-derived contacts may reappear on the next incoming message.
Instructions
Delete a contact by id, removing it from the account and from every device syncing the address book. A contact derived from mail headers or calendar attendees is only removed until the next message from that person recreates it — to drop one field instead of the whole record, use update_contact; if it duplicates another contact of the same person or organization, use merge_contacts, which keeps its addresses, notes and history. Find the id with search_contacts.
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": "delete_contact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| contactId | Yes | The contact id, as printed by search_contacts under `contact_id`. |