List timesheets
Timesheets for a pay period with member, status, tracked time and activity levels.
MCP tool hubstaff_read → list_timesheets
read
Lists timesheets, the approval records Hubstaff builds from each member's pay period, not single time entries. Filter by status (open, submitted, approved or denied) and by dates. Tracked time is in seconds; keyboard, mouse and overall are percentages.
Parameters
| Name | Type | Description |
|---|---|---|
| organization_id integer required | integer | Organization ID from list_organizations. |
| status string | string | open, submitted, approved or denied. |
| start_date date | date | First day of the range, ISO 8601. |
| stop_date date | date | Last day of the range, ISO 8601, inclusive. |
| limit integer | integer | 1 to 100. Default: 50. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "hubstaff_read",
"arguments": {
"operation": "list_timesheets",
"arguments": {
"organization_id": 1
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"timesheets": [
{
"timesheet_id": 8841201,
"user_id": 3011,
"status": "submitted",
"start_date": "2026-10-06",
"stop_date": "2026-10-12",
"tracked": 144000,
"overall": 58,
"submitted_on": "2026-10-13"
},
{
"timesheet_id": 8841202,
"user_id": 3012,
"status": "submitted",
"start_date": "2026-10-06",
"stop_date": "2026-10-12",
"tracked": 136800,
"overall": 49,
"submitted_on": "2026-10-13"
}
],
"next_cursor": null
},
"isError": false
}