--- title: "Todoist Integration" description: "Manage Todoist tasks, projects, sections, labels, and comments from your flows, with natural-language due dates. Agents capture actionable messages as tasks and confirm before assigning work to a teammate." url: https://flowrunner.ai/integrations/todoist date_modified: 2026-08-01T02:40:32-07:00 --- # Todoist [Productivity](https://flowrunner.ai/integrations/category/project-management-productivity) Manage Todoist tasks, projects, sections, labels, and comments from your flows, with natural-language due dates. Agents capture actionable messages as tasks and confirm before assigning work to a teammate. [Verified](https://flowrunner.ai/integrations/verified "What does verified mean?") · 26 actions · API key · available [Todoist website](https://todoist.com/) · [Platform Documentation](https://developer.todoist.com/api/v1) · Capability data verified 2026-07-14 1. An actionable email or message arrives, captured upstream 2. Agent reads the sender, subject, and the request in the body 3. Agent confirms the message actually needs a follow-up task 4. Agent decides the project, priority, and due date from the request 5. Agent creates the task with a natural-language due date and labels 6. Agent records the source message in the task so context is preserved 7. A task that should be assigned to a teammate is routed for a person to confirm ## What This Integration Enables FlowRunner agents use Todoist to capture and route work as decisions, not manual entry. An agent can create a task from an email, form, or message, setting a natural-language due date like "tomorrow at 5pm" or "every Monday" and a friendly priority. It can move tasks between projects and sections, manage labels, and post or read comments as a workflow progresses. On shared projects it reads collaborators so it can assign the right person. The routine capture runs on its own. The task that needs a human to own it, or a comment that needs a person to answer, is where the agent stops to ask. ### Without FlowRunner **Inbox as task list**: Actionable requests live in an inbox until someone copies them out by hand **Missed follow-ups**: Requests slip because no task was ever created **Inconsistent due dates**: Deadlines get set from memory or not at all ### With FlowRunner **Requests become tasks**: Actionable messages are turned into Todoist tasks the moment they arrive **Nothing slips**: Every request that needs follow-up gets a task with a due date **Consistent scheduling**: Due dates are set the same way, using natural language the agent parses ## Use Case Scenarios ### Email to Follow-Up Task An actionable email arrives. The agent reads it, decides the project and priority, and creates a task with Create Task, setting a natural-language Due String so the follow-up is scheduled. It records the sender and subject in the task so the context travels with it. The inbox stops doubling as a task list. ### Project-Plan Import A project plan lives in a spreadsheet. The agent reads each row and calls Create Task for each item, placing tasks in the right project and section with labels applied. Because the agent parses due dates from the plan's own language, the imported tasks land already scheduled. ### Shared-Project Assignment with a Human Gate A request comes in that belongs to a teammate on a shared project. The agent drafts the task, reads the project's collaborators, and picks the likely owner. Before it assigns the task to a specific person, it confirms the assignment with a lead so no one is handed work without a human in the loop. ## Human-in-Loop Highlight When an agent creates a task on a shared project and needs to assign it to a specific teammate, it does not just hand the work over. Assigning a person work is a call that should have a human behind it. The agent pauses and routes to the project lead through their preferred channel: "This request looks like it belongs to \[collaborator\] on \[project\]. Assign the task to them, pick someone else, or leave it unassigned?" The lead decides, and the agent runs Update Task to set the assignee from there. The capture and scheduling run on their own; handing a person work reaches a person first. Agent processes routinely Detects exception requiring judgment Clear match Continues automatically Ambiguous Routes to human via preferred channel Human decides Agent resumes with decision ## Agent Capabilities 26 actions ### Tasks 8 - **Create Task** Creates a task with content, project, section, labels, priority, and a due date given as natural language or a fixed date. Used to turn a message or row into scheduled work. - **Get Task** Retrieves a single active task with its content, project, labels, priority, and due date. Used to read current state before acting. - **List Tasks** Lists active tasks, filtered by project, section, label, or a Todoist filter query like "today | overdue". Used to find the tasks a workflow should process. - **Update Task** Updates a task's content, labels, priority, due date, or assignee. Only the fields provided are changed. Used to reschedule, reclassify, or assign a task. - **Close Task** Completes a task, advancing recurring tasks to their next occurrence. Used to mark work done. - **Reopen Task** Reopens a completed task and restores it to active. Used to reverse a premature close. - **Delete Task** Permanently deletes a task and its subtasks. Used in cleanup. - **Move Task** Moves a task to a different project or section, or nests it under a parent task. Used to reorganize work. ### Projects 6 - **Create Project** Creates a project with a color, optional parent, favorite flag, and default view. Used to provision project structure on demand. - **List Projects** Lists the user's projects, paged via a cursor. Used to resolve which project to file work in. - **Get Project** Retrieves a single project with its color, view style, and favorite status. Used to inspect a project. - **Update Project** Updates a project's name, color, favorite status, or view style. Used to keep project settings in sync. - **Delete Project** Permanently deletes a project with its sections and tasks. Used in cleanup. - **Get Collaborators** Lists the collaborators on a shared project with their user IDs, names, and emails. Used to resolve who a task can be assigned to. ### Sections 3 - **Create Section** Creates a section within a project. Used to structure a project into stages. - **List Sections** Lists sections, optionally restricted to one project. Used to find where a task should live. - **Delete Section** Permanently deletes a section and its tasks. Used in cleanup. ### Labels 4 - **Create Label** Creates a personal label with a color and ordering. Used to build the labels a routing scheme depends on. - **List Labels** Lists the user's personal labels. Used to resolve which labels are available. - **Update Label** Renames or recolors a label, updating it on every task that carries it. Used to maintain a label scheme. - **Delete Label** Permanently deletes a label and removes it from all tasks. Used in cleanup. ### Comments 5 - **Create Comment** Adds a comment to a task or a project. Used by agents to log a note or ask a question. - **List Comments** Lists comments on a task or project. Used to read the discussion before acting. - **Get Comment** Retrieves a single comment with its content and author. Used to inspect a specific note. - **Update Comment** Updates the content of an existing comment. Used to correct or extend a note. - **Delete Comment** Permanently deletes a comment. Used in cleanup. ## Frequently Asked Questions ### What can FlowRunner do with Todoist? FlowRunner agents can run Create Task, Get Task, and List Tasks in Todoist, plus 23 more actions. ### Does connecting Todoist to FlowRunner require OAuth? No. Todoist connects to FlowRunner with an API key, no OAuth flow required. ### Can Todoist trigger a FlowRunner workflow automatically? Todoist doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger. **Work at Todoist?** This integration exposes Todoist to AI agents on every FlowRunner plan, including through MCP, at no cost to you. [See what FlowRunner offers integration partners](https://flowrunner.ai/integrations/partners), including how to keep this page current. --- Markdown version of https://flowrunner.ai/integrations/todoist. Site index: https://flowrunner.ai/llms.txt