Get a timesheet
One employee's timesheet day by day, with clock in, clock out, hours and locked days.
MCP tool connecteam_read → get_timesheet
read
Returns the days of one employee in the dates you pass, in date order, each with its time entries (clock_in, clock_out), the hours for the day and whether the day is locked. total_hours is the sum of the days. Read it before approve_timesheet to judge the hours.
Parameters
| Name | Type | Description |
|---|---|---|
| time_clock_id integer required | integer | Time clock ID from list_time_clocks. |
| user_id integer required | integer | User ID from list_users or list_timesheets. |
| period_start date required | date | First day of the pay period, YYYY-MM-DD. |
| period_end date required | date | Last day of the pay period, YYYY-MM-DD. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "connecteam_read",
"arguments": {
"operation": "get_timesheet",
"arguments": {
"time_clock_id": 1,
"user_id": 1,
"period_start": "2026-10-01",
"period_end": "2026-10-01"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"user_id": 8821051,
"name": "Luis Ortega",
"period_start": "2026-10-12",
"period_end": "2026-10-18",
"days": [
{
"date": "2026-10-12",
"entries": [
{
"clock_in": "08:00",
"clock_out": "16:00"
}
],
"hours": 8,
"locked": false
},
{
"date": "2026-10-13",
"entries": [
{
"clock_in": "08:00",
"clock_out": "16:30"
}
],
"hours": 8.5,
"locked": false
},
{
"date": "2026-10-14",
"entries": [
{
"clock_in": "07:30",
"clock_out": "17:00"
}
],
"hours": 9.5,
"locked": false
},
{
"date": "2026-10-15",
"entries": [
{
"clock_in": "08:00",
"clock_out": "16:00"
}
],
"hours": 8,
"locked": false
},
{
"date": "2026-10-16",
"entries": [
{
"clock_in": "09:00",
"clock_out": "16:00"
}
],
"hours": 7,
"locked": false
}
],
"total_hours": 41
},
"isError": false
}