List Tasks
task_listRead-only
Retrieve and filter tracked time entries by date, project, team, or user. Supports pagination to control how many tasks are returned.
Instructions
Use this when the user wants to view their time entries. IMPORTANT: When the user asks for a specific number (e.g., "show me 10 tasks"), use the limit parameter to control how many tasks are returned. Always use pagination to avoid loading all tasks unnecessarily. Supports extensive filtering by organization, team, project, user, tags, and more.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of tasks to return. Use this when user asks for a specific number (e.g., "10 tasks" = limit: 10). Defaults to 20 if not specified. | |
| page | No | Page number for pagination (1-based). Use with limit to fetch subsequent pages. | |
| sort | No | Sort field for tasks: dateTime=by start/end time, time=by duration, created=by creation date | |
| order | No | Sort order (ascending or descending) | |
| startDate | No | Filter tasks starting on or after this date (YYYY-MM-DD format) | |
| endDate | No | Filter tasks ending on or before this date (YYYY-MM-DD format) | |
| organizationId | No | Filter tasks by organization ID | |
| teamId | No | Filter tasks by team ID | |
| teamIds | No | Filter tasks by multiple team IDs | |
| projectId | No | Filter tasks for a specific project | |
| projectIds | No | Filter tasks by multiple project IDs | |
| todoId | No | Filter tasks associated with a specific todo/task item | |
| taskIds | No | Filter specific tasks by IDs | |
| rateId | No | Filter tasks by rate/billing rate ID | |
| documentId | No | Filter tasks associated with a specific document | |
| type | No | Filter tasks by type: all=all types, task=regular time entries, mileage=mileage entries, call=call entries | |
| filter | No | Filter tasks by billing/payment status: all=all tasks, billable=only billable, notBillable=non-billable, paid=payment received, unpaid=not paid, billed=invoice sent, outstanding=billed but unpaid | |
| excludeTaskIds | No | Exclude specific task IDs from results | |
| tagIds | No | Filter tasks by tag IDs | |
| userIds | No | Filter tasks by user IDs (task owners) | |
| feelings | No | Filter tasks by feeling/satisfaction ratings (1-5) | |
| populatePauses | No | Include pause/break information in task details | |
| populateExpenses | No | Include expense information in task details | |
| populateNotes | No | Include notes in task details | |
| populateTags | No | Include tag details in task information |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tasks | Yes | List of tasks matching the criteria |