List timesheets
Timesheets of a location, oldest first, pending or approved.
MCP tool deputy_read → list_timesheets
read
Returns timesheets of one location in date order, oldest first, the order Deputy recommends for approval. status pending (default) lists those waiting for approval, approved lists the done ones. Each row has start, end and break, and a missing end time is shown as null. Pay figures need the Location Manager or System Administrator role.
Parameters
| Name | Type | Description |
|---|---|---|
| location_id integer required | integer | Location ID from list_locations. |
| status enum | enum | pending (default) or approved. |
| date_from date | date | First day, YYYY-MM-DD. |
| date_to date | date | Last day, YYYY-MM-DD. |
| employee_id integer | integer | Only this employee's timesheets. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "deputy_read",
"arguments": {
"operation": "list_timesheets",
"arguments": {
"location_id": 1
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"timesheets": [
{
"timesheet_id": 4821,
"employee": "Ana Lopez",
"date": "2026-10-12",
"start": "09:00",
"end": "17:30",
"break_minutes": 30,
"hours": 8,
"status": "pending"
},
{
"timesheet_id": 4822,
"employee": "Tom Becker",
"date": "2026-10-12",
"start": "10:00",
"end": null,
"break_minutes": 0,
"hours": null,
"status": "pending"
}
]
},
"isError": false
}