book_appointment
Verify the requested time is free, then book the appointment. Uses a dry run by default; set confirm:true to actually book.
Instructions
Book an appointment. Verifies the requested time is a real free slot first, then writes. DRY RUN BY DEFAULT: pass confirm:true to actually book.
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": {
"calendarId": "<calendarId>",
"contactId": "<contactId>",
"startTime": "<startTime>",
"endTime": "<endTime>"
},
"name": "book_appointment"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | ||
| confirm | No | Must be exactly boolean true to actually book. Anything else is a dry run. | |
| endTime | Yes | ISO 8601 with offset | |
| timezone | No | IANA tz used for the availability check, default America/New_York | |
| contactId | Yes | ||
| startTime | Yes | ISO 8601 with offset, e.g. 2026-08-05T13:15:00-04:00 | |
| calendarId | Yes |