Todoist

This connector uses the Todoist API v1 (the modern unified API — the older /rest/v2 and /sync/v9 are deprecated).

Setup:

1. Sign in to https://todoist.com → top-right avatar → Settings → Integrations → Developer → API token → Copy.
2. Set TODOIST_API_TOKEN to it.

Authentication: Authorization: Bearer ${TODOIST_API_TOKEN}. The token is per-user; everything done with it appears as that user's actions. Personal API tokens never expire.

Hierarchy: Project → Section (optional) → Task → Sub-task. Tasks can also live directly in a project without a section. The Inbox is a special project (inbox_project=true).

Date strings: Todoist accepts natural language for due_string (e.g. 'tomorrow at noon', 'every monday 9am', 'in 3 days', 'next friday') OR explicit due_date (YYYY-MM-DD) / due_datetime (ISO 8601 RFC 3339). For recurring tasks, the natural-language form is required to set recurrence rules.

Priorities: 1-4 in the API (1=lowest, 4=urgent). The Todoist UI shows them inverted (P1 in UI = priority 4 in API).

Filters: when listing tasks via todoist_get_active_tasks, the filter parameter accepts Todoist's filter syntax: 'today', 'overdue', 'p1 & @work', 'due before: +7 days', etc.

Pagination: not used — the REST API returns full lists (sometimes thousands of items). Use filters to narrow.

Rate limits: 1000 requests per 15 min per user. On 429 back off.

Sync API not exposed here: Todoist also has a Sync API (single batch endpoint that returns all data at once) — useful for full local mirrors but more complex. This connector uses the simpler REST endpoints.

Out of scope here: webhooks, attachments upload, project sharing/collaboration changes (only show collaborators), karma stats, premium-only filters management.