# Todoist AI integration on Definable

> Todoist is a task management tool allowing users to create to-do lists, set deadlines, and collaborate on projects with reminders and cross-platform syncing

## What this connects

Todoist is a task management tool allowing users to create to-do lists, set deadlines, and collaborate on projects with reminders and cross-platform syncing

Vendor: https://www.todoist.com/

## Tools available

**76** tools available. First 12:

- `TODOIST_ADD_WORKSPACE` — Add Workspace — Tool to create a new workspace in Todoist. Use when you need a separate workspace to organize projects. Generates UUID and temp_id automatically.
- `TODOIST_ARCHIVE_PROJECT2` — Archive Project (API v1) — Tool to archive a project using Todoist API v1. For personal projects, archives it for the initiating user. For workspace projects, archives it for all workspace users.
- `TODOIST_BULK_CREATE_TASKS` — Bulk Create Tasks — Create many tasks in one request using Todoist's Sync batching. Use when scaffolding projects or creating multiple tasks at once to reduce round trips.
- `TODOIST_CLOSE_TASK` — Close Task (Deprecated) — DEPRECATED: Use TODOIST_CLOSE_TASK_V1 instead. This tool marks an existing task as completed in Todoist. It requires the `task_id` of the task to be closed. Closing an already-completed task returns an error; check task state first if idempotent behavior is needed.
- `TODOIST_CLOSE_TASK_V1` — Close Task (API v1) — Tool to close (complete) a task in Todoist using API v1. Use when you need to mark a task as complete using the v1 endpoint.
- `TODOIST_CREATE_COMMENT_V1` — Create Comment (API v1) — Tool to create a new comment on a project or task using Todoist API v1. Use when you need to add a note to a specific task or project. IMPORTANT: You must provide EXACTLY ONE of task_id or project_id - these parameters are mutually exclusive. - To comment on a task, provide task_id (and omit project_id) - To comment on a project, provide project_id (and omit task_id) - Providing both task_id AND project_id will cause an error.
- `TODOIST_CREATE_LABEL` — Create Label (Deprecated) — DEPRECATED: Use TODOIST_CREATE_LABEL_V1 instead. Creates a new label.
- `TODOIST_CREATE_LABEL_V1` — Create Label (API v1) — Tool to create a new personal label using API v1. Use when you need to add a new label to organize tasks.
- `TODOIST_CREATE_PROJECT` — Create Project (Deprecated) — DEPRECATED: Use TODOIST_TODOIST_CREATE_PROJECT2 instead. Creates a new project in Todoist. Project names are not unique; use the returned project_id for subsequent operations to avoid ambiguous matches.
- `TODOIST_CREATE_PROJECT2` — Create Project (API v1) — Tool to create a new project in Todoist using the unified API v1. Use when you need to create a new project with specific parameters like name, color, or parent project.
- `TODOIST_CREATE_SECTION` — Create Section (Deprecated) — DEPRECATED: Use TODOIST_CREATE_SECTION_V1 instead. Tool to create a new section within a specific project. Use when you need to group tasks under a new heading in a project.
- `TODOIST_CREATE_SECTION_V1` — Create Section (API v1) — Tool to create a new section within a project using API v1. Use when you need to organize tasks under a new heading in a project.

## Auth

Auth schemes: `OAUTH2`. Managed by Definable: `OAUTH2` — no client credentials required from the user.

## How agents use Todoist

Inside a Definable workflow, Todoist is one of the tools the **Distributor specialist** can call. Example coordination patterns:

- **Researcher → Todoist** — the Researcher (GPT-5.5) pulls context from Todoist (records, threads, documents), synthesises findings, and briefs the rest of the team.
- **Writer → Distributor → Todoist** — the Writer (Claude Opus 4.7) drafts copy in brand voice, the Verifier passes it, then the Distributor writes the result into Todoist (create record, post message, draft email).
- **Designer / Engineer → Distributor → Todoist** — the Designer ships an asset or the Engineer ships a code change, the Distributor delivers it via Todoist (attach file, open PR comment, post status).

The Verifier checks every Todoist call. On rate limit, schema drift, or auth refresh it self-heals and retries — the workflow completes without manual intervention.

## Categories

- task management — https://definable.ai/apps/category/task-management/
- productivity — https://definable.ai/apps/category/productivity/

## Related

- HTML page: https://definable.ai/apps/todoist/
- Same category (task management): https://definable.ai/apps/category/task-management/
- All integrations: https://definable.ai/apps/
- Workflow (multi-agent loop): https://definable.ai/workflow/
- Apps llms.txt index: https://definable.ai/llms-apps.txt