get_tasks
Retrieve tasks from Todoist with optional filters like project, labels, priority, due date, or task name. Return all tasks if no filters are applied. Supports limiting results and identifying overdue tasks.
Instructions
Fetch user's tasks. These can be filtered by project, labels, time, etc. If no filters are provided, all tasks are returned.
Args:
- project_id: The string ID of the project to fetch tasks from. Example '1234567890'
- project_name: Name of the project to fetch tasks from. Example 'Work' or 'Inbox'
- task_name: Filter tasks by name. Example 'Buy groceries'
- labels: List of tags used to filter tasks.
- priority: Filter tasks by priority level. 4 (urgent), 3 (high), 2 (normal), 1 (low)
- due_date: Specific due date in YYYY-MM-DD format. Example '2021-12-31'
- is_overdue: Filter tasks that are overdue.
- limit: Maximum number of tasks to return. Default is all.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| due_date | No | ||
| is_overdue | No | ||
| labels | No | ||
| limit | No | ||
| priority | No | ||
| project_id | No | ||
| project_name | No | ||
| task_name | No |
Input Schema (JSON Schema)
{
"properties": {
"due_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Due Date"
},
"is_overdue": {
"anyOf": [
{
"type": "boolean"
},
{
"type": "null"
}
],
"default": null,
"title": "Is Overdue"
},
"labels": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"title": "Labels"
},
"limit": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Limit"
},
"priority": {
"anyOf": [
{
"enum": [
1,
2,
3,
4
],
"type": "integer"
},
{
"type": "null"
}
],
"default": null,
"title": "Priority"
},
"project_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Project Id"
},
"project_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Project Name"
},
"task_name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"title": "Task Name"
}
},
"title": "get_tasksArguments",
"type": "object"
}