Book time off
Request leave for yourself or, as a manager or admin, for someone else.
MCP tool timetastic_write → book_time_off
write Confirm
Returns the request id, the days booked, the status and the approver. When a department limit blocks an employee booking for themselves, the call returns Timetastic's message and books nothing. The approver gets an email. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| who_for string required | string | Full name of the person the leave is for, as in the Who for field. |
| from_date string required | string | First day, YYYY-MM-DD. |
| to_date string required | string | Last day, YYYY-MM-DD. |
| leave_type string required | string | Leave type as the Type drop-down lists it, for example Holiday or Sick leave. |
| reason string | string | Optional reason the approver reads. |
| confirm_override boolean | boolean | Manager or admin only: book anyway when Timetastic shows a staffing warning. Defaults to false. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "timetastic_write",
"arguments": {
"operation": "book_time_off",
"arguments": {
"who_for": "Ana Torres",
"from_date": "2026-12-21",
"to_date": "2026-12-24",
"leave_type": "Holiday",
"reason": "Christmas week"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"request_id": "5129012",
"employee": "Ana Torres",
"leave_type": "Holiday",
"from": "2026-12-21",
"to": "2026-12-24",
"days": 4,
"status": "Pending",
"approver": "Priya Nair",
"warning": null
},
"isError": false
}