List time off
Time off periods in a date window, with status, newest first.
MCP tool personio_read → list_time_off
read
Lists time off periods that overlap the window you give, newest first. Each item has the employee, the type, the dates and a status of approved or pending. Filter by employee or team to check who is away. Pages hold up to 100 items; pass next_cursor back as cursor.
Parameters
| Name | Type | Description |
|---|---|---|
| from string required | string | Window start, YYYY-MM-DD. |
| to string required | string | Window end, YYYY-MM-DD. |
| employee_id string | string | Only this employee. |
| team string | string | Only this team. |
| status string | string | 'approved' or 'pending'. Default both. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "personio_read",
"arguments": {
"operation": "list_time_off",
"arguments": {
"from": "from",
"to": "to"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"time_off": [
{
"time_off_id": "to_93a1",
"employee_id": "emp_2041",
"name": "Maja Kowalska",
"time_off_type": "Vacation",
"start_date": "2026-12-24",
"end_date": "2026-12-26",
"days": 3,
"status": "approved"
}
],
"next_cursor": null
},
"isError": false
}