ClickUp MCP Server

by v4lheru
Verified

get_tasks

Retrieve tasks from a ClickUp list with optional filtering capabilities. Use this tool when you need to see existing tasks or analyze your current workload. Before calling, check if you already have the necessary list ID from previous responses in the conversation, as this avoids redundant lookups. Results can be filtered by status, assignees, dates, and more.

Input Schema

NameRequiredDescriptionDefault
archivedNoSet to true to include archived tasks in the results
assigneesNoArray of user IDs to filter tasks by assignee
custom_fieldsNoObject with custom field IDs as keys and desired values for filtering
date_created_gtNoFilter tasks created after this timestamp (Unix milliseconds)
date_created_ltNoFilter tasks created before this timestamp (Unix milliseconds)
date_updated_gtNoFilter tasks updated after this timestamp (Unix milliseconds)
date_updated_ltNoFilter tasks updated before this timestamp (Unix milliseconds)
due_date_gtNoFilter tasks due after this timestamp (Unix milliseconds)
due_date_ltNoFilter tasks due before this timestamp (Unix milliseconds)
include_closedNoSet to true to include tasks with 'Closed' status
listIdNoID of the list to get tasks from (optional if using listName instead). If you have this ID from a previous response, use it directly rather than looking up by name.
listNameNoName of the list to get tasks from - will automatically find the list by name (optional if using listId instead). Only use this if you don't already have the list ID from previous responses.
order_byNoField to order tasks by (e.g., 'due_date', 'created', 'updated')
pageNoPage number for pagination when dealing with many tasks (starts at 0)
reverseNoSet to true to reverse the sort order (descending instead of ascending)
statusesNoArray of status names to filter tasks by (e.g., ['To Do', 'In Progress'])
subtasksNoSet to true to include subtasks in the results

Input Schema (JSON Schema)

{ "oneOf": [ { "required": [ "listId" ] }, { "required": [ "listName" ] } ], "properties": { "archived": { "description": "Set to true to include archived tasks in the results", "type": "boolean" }, "assignees": { "description": "Array of user IDs to filter tasks by assignee", "items": { "type": "string" }, "type": "array" }, "custom_fields": { "description": "Object with custom field IDs as keys and desired values for filtering", "type": "object" }, "date_created_gt": { "description": "Filter tasks created after this timestamp (Unix milliseconds)", "type": "number" }, "date_created_lt": { "description": "Filter tasks created before this timestamp (Unix milliseconds)", "type": "number" }, "date_updated_gt": { "description": "Filter tasks updated after this timestamp (Unix milliseconds)", "type": "number" }, "date_updated_lt": { "description": "Filter tasks updated before this timestamp (Unix milliseconds)", "type": "number" }, "due_date_gt": { "description": "Filter tasks due after this timestamp (Unix milliseconds)", "type": "number" }, "due_date_lt": { "description": "Filter tasks due before this timestamp (Unix milliseconds)", "type": "number" }, "include_closed": { "description": "Set to true to include tasks with 'Closed' status", "type": "boolean" }, "listId": { "description": "ID of the list to get tasks from (optional if using listName instead). If you have this ID from a previous response, use it directly rather than looking up by name.", "type": "string" }, "listName": { "description": "Name of the list to get tasks from - will automatically find the list by name (optional if using listId instead). Only use this if you don't already have the list ID from previous responses.", "type": "string" }, "order_by": { "description": "Field to order tasks by (e.g., 'due_date', 'created', 'updated')", "type": "string" }, "page": { "description": "Page number for pagination when dealing with many tasks (starts at 0)", "type": "number" }, "reverse": { "description": "Set to true to reverse the sort order (descending instead of ascending)", "type": "boolean" }, "statuses": { "description": "Array of status names to filter tasks by (e.g., ['To Do', 'In Progress'])", "items": { "type": "string" }, "type": "array" }, "subtasks": { "description": "Set to true to include subtasks in the results", "type": "boolean" } }, "type": "object" }