Create contact
create_contactCreate an address book contact for a new person, adding name, emails, phones, addresses, organization, birthday, note, and roles. Search contacts first and update existing records instead.
Instructions
Create a contact in the user’s address book — a person the address book does not yet know, typically because they have never sent mail or shared a calendar event. Holds a name plus optional email addresses, phone numbers, structured postal addresses, an organization, a birthday, a note, and roles: what the person is to the user ("lawyer"), stored only when the user said or confirmed it. Search with search_contacts first: if the person is already known, use update_contact instead so their history stays on one record. The contact syncs to the user’s devices over CardDAV.
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": {
"name": "<name>"
},
"name": "create_contact"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | The display name, e.g. "Robin Fairweather". | |
| note | No | Free-text note about the person. | |
| roles | No | What the person is to the user ("lawyer", "landlord"), so a later "write to my lawyer" finds them. Only roles the user said or confirmed; never inferred from mail. | |
| emails | No | Email addresses for this person. A contact does not need one — a name alone is a valid record. | |
| phones | No | Phone numbers for this person. | |
| birthday | No | Birthday as `YYYY-MM-DD`, or `--MM-DD` when the year is unknown. | |
| organization | No | Company or organization the person belongs to. | |
| postalAddresses | No | Postal addresses, structured by component. |