Get employee planner
Reads one employee's holidays or absences for a date range from their Planner tab.
MCP tool peoplehr_read → get_employee_planner
read
Returns each entry in the range with its dates and duration in days, in date order. Holidays include the status of the request. Anything that deducts days from the entitlement, emergency leave included, shows up under holidays.
Parameters
| Name | Type | Description |
|---|---|---|
| employee_id string required | string | Employee ID from list_employees, for example PW15. |
| type string required | string | holidays or absences. |
| start_date string required | string | First day, YYYY-MM-DD. |
| end_date string required | string | Last day, YYYY-MM-DD. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "peoplehr_read",
"arguments": {
"operation": "get_employee_planner",
"arguments": {
"employee_id": "employee_8c41d2",
"type": "type",
"start_date": "start date",
"end_date": "end date"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"employee_id": "PW15",
"type": "holidays",
"entries": [
{
"start_date": "2026-11-16",
"end_date": "2026-11-18",
"duration_days": 3,
"status": "Pending"
},
{
"start_date": "2026-11-26",
"end_date": "2026-11-27",
"duration_days": 2,
"status": "Approved"
}
]
},
"isError": false
}