List time off requests
Time off requests with employee, policy type, dates and status, pending first.
MCP tool connecteam_read → list_time_off_requests
read
Returns the requests of the users your account can act on: users you manage directly or whose smart group you administer. status pending is the Pending Requests window, approved and declined show past decisions. Each row has request_id, employee, policy type, dates and days. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | pending (default), approved or declined. |
| start_date date | date | Only requests that end on or after this date. |
| end_date date | date | Only requests that start on or before this date. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "connecteam_read",
"arguments": {
"operation": "list_time_off_requests",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"requests": [
{
"request_id": "5528",
"user_id": 8821077,
"name": "Priya Nair",
"policy_type": "Vacation",
"start_date": "2026-10-22",
"end_date": "2026-10-23",
"days": 2,
"status": "pending"
},
{
"request_id": "5531",
"user_id": 8821090,
"name": "Marco Bell",
"policy_type": "Vacation",
"start_date": "2026-12-14",
"end_date": "2026-12-23",
"days": 8,
"status": "pending"
}
],
"next_cursor": null
},
"isError": false
}