Todoist MCP Server

by Chrusic
Verified

todoist_get_tasks

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

Input Schema

NameRequiredDescriptionDefault
filterNoNatural language filter like 'today', 'tomorrow', 'next week', 'priority 1', 'overdue' (optional)
idsNoArray of specific task IDs to retrieve (optional)
labelNoFilter tasks by label name (optional)
langNoIETF language tag defining what language filter is written in (optional)
limitNoMaximum number of tasks to return (optional, client-side filtering)
priorityNoFilter by priority level (1-4) (optional)
project_idNoFilter tasks by project ID (optional)
section_idNoFilter 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" }