todoist_get_tasks

Retrieve tasks from Todoist using filters like due date, priority, labels, or specific task IDs. Supports batch retrieval and client-side limits for streamlined task management.

Instructions

Get a list of tasks from Todoist with various filters - handles both single and batch retrieval

Input Schema

Name	Required	Description
`filter`	No	Natural language filter like 'today', 'tomorrow', 'next week', 'priority 1', 'overdue' (optional)
`ids`	No	Array of specific task IDs to retrieve (optional)
`label`	No	Filter tasks by label name (optional)
`lang`	No	IETF language tag defining what language filter is written in (optional)
`limit`	No	Maximum number of tasks to return (optional, client-side filtering)
`priority`	No	Filter by priority level (1-4) (optional)
`project_id`	No	Filter tasks by project ID (optional)
`section_id`	No	Filter tasks by section ID (optional)

Input Schema (JSON Schema)

{
  "properties": {
    "filter": {
      "description": "Natural language filter like 'today', 'tomorrow', 'next week', 'priority 1', 'overdue' (optional)",
      "type": "string"
    },
    "ids": {
      "description": "Array of specific task IDs to retrieve (optional)",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "label": {
      "description": "Filter tasks by label name (optional)",
      "type": "string"
    },
    "lang": {
      "description": "IETF language tag defining what language filter is written in (optional)",
      "type": "string"
    },
    "limit": {
      "default": 10,
      "description": "Maximum number of tasks to return (optional, client-side filtering)",
      "type": "number"
    },
    "priority": {
      "description": "Filter by priority level (1-4) (optional)",
      "enum": [
        1,
        2,
        3,
        4
      ],
      "type": "number"
    },
    "project_id": {
      "description": "Filter tasks by project ID (optional)",
      "type": "string"
    },
    "section_id": {
      "description": "Filter tasks by section ID (optional)",
      "type": "string"
    }
  },
  "type": "object"
}

Todoist MCP Server

todoist_get_tasks

Instructions

Input Schema

Input Schema (JSON Schema)

Other Tools from Todoist MCP Server

Related Tools