clickup_get_tasks
Retrieve tasks from one ClickUp List using filters like status, assignee, tags, and due date, with sorting and pagination.
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 |