List shifts
Shifts of a location between two dates, draft, open and published.
MCP tool deputy_read → list_shifts
read
Returns shifts (Deputy calls them rosters) of one location between two dates, in start order. Each shift says whether it is published, open (no employee yet) or a draft only managers see. Without dates, Deputy returns its default window around now, so pass both dates to read a week.
Parameters
| Name | Type | Description |
|---|---|---|
| location_id integer required | integer | Location ID from list_locations. |
| date_from date required | date | First day, YYYY-MM-DD. |
| date_to date required | date | Last day, YYYY-MM-DD. |
| employee_id integer | integer | Only this employee's shifts. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "deputy_read",
"arguments": {
"operation": "list_shifts",
"arguments": {
"location_id": 1,
"date_from": "2026-10-01",
"date_to": "2026-10-01"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"shifts": [
{
"shift_id": 714,
"date": "2026-10-19",
"start": "09:00",
"end": "17:00",
"employee": "Ana Lopez",
"state": "published"
},
{
"shift_id": 715,
"date": "2026-10-19",
"start": "12:00",
"end": "20:00",
"employee": null,
"state": "open"
}
]
},
"isError": false
}