clickup_get_tasks
List tasks from a single ClickUp list filtered by status, assignees, tags, due dates, and sorted by selected fields.
Instructions
List tasks inside ONE List, with filters and sorting.
Calls GET /list/{list_id}/task. Scope is a single List. Filter by statuses,
assignees, tags, custom task types, and date ranges (created/updated/due/done,
all unix ms), and sort with order_by + reverse.
When to Use:
You know the List and want its tasks (a sprint board, a backlog column).
When NOT to Use:
You need tasks across several Lists/Folders/Spaces at once, or you do not know which List they live in — use
clickup_get_filtered_team_tasks, which searches the whole Workspace.You already have a task id — use
clickup_get_task.
Returns: A paginated markdown summary (one bullet per task) or JSON. Only the first 50 tasks of a page are rendered to stay under the size limit.
Pagination:
Page-based: pass page (0-indexed, up to 100 tasks per page). When the tool
reports "More available", request the next page number.
Examples:
params = {"list_id": "901", "statuses": ["in progress"], "order_by": "due_date"}Next page:
params = {"list_id": "901", "page": 1}
Error Handling:
404 means the List id is wrong; an empty result is a valid page past the end.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |