Todoist for AI agents

Agents read Todoist at once. Changes and sends are held for a person's approval by default.

About Todoist

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 an agent can do in Todoist

Every Todoist action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.

Runs at once (reads)

Looks things up in Todoist without asking first. 40 actions.

  • Export Template As URLTool to export a Todoist project as a shareable template URL. Use when you need to share a project structure or create copies from a template.
  • Filter TasksTool to get all tasks matching the filter. Use when you need to retrieve tasks based on specific filter criteria. This is a paginated endpoint using cursor-based pagination.
  • Get All CommentsThis tool retrieves all comments associated with a specific task or project in Todoist. You must provide exactly one of task_id or project_id (they are mutually exclusive - do not provide both). Retur
  • Get all projectsGet all projects from a user's Todoist account. Retrieves all active (non-archived) projects; use TODOIST_LIST_ARCHIVED_WORKSPACE_PROJECTS for archived ones. Response returns the list in the projects
  • Get All TasksFetches all INCOMPLETE tasks from Todoist and returns their details. Supports cursor-based pagination. IMPORTANT LIMITATIONS: - This endpoint only returns active (incomplete) tasks - Cannot retrieve c
  • Get BackupsTool to list all available backup archives for the user. Returns archive metadata only — not live task or project data; do not use as a proxy for active data availability. May return an empty list if
  • Get Completed Tasks By Completion DateTool to retrieve completed tasks within a specified completion date window. Use when you need to fetch historical completed tasks for reporting, audits, or weekly summaries. The API restricts the comp
  • Get Personal LabelTool to retrieve a personal label by its ID. Use when you need to fetch details about a specific personal label.
  • Get Productivity StatsTool to retrieve comprehensive productivity statistics for the authenticated user. Use when you need detailed completion data, karma scores, streaks, or goal tracking information for productivity repo
  • Get Project (API v1)Tool to retrieve a specific project by its ID using Todoist API v1. Use when you have a project ID and need its metadata before display or update. Verify project_id matches the intended project before
  • Get Full Project DataTool to retrieve full project data including all sections, tasks, and collaborators. Use when you need comprehensive project information beyond basic metadata.
  • Get Special BackupsTool to list special backup archives for the authenticated user's projects. Returns an empty list if no backups exist — callers must not assume archives are present. Read-only: confirms archive visibi
Show all 40
  • Get UserTool to retrieve information about the currently authenticated user. Use when you need user details like email, name, preferences, karma, or subscription status.
  • List Archived Workspace ProjectsTool to list all archived projects in a workspace. Archived projects are excluded from TODOIST_GET_ALL_PROJECTS; combine both tools when a complete project list is needed. Use when you need to retriev
  • List Completed TasksTool to retrieve all completed tasks with optional project filtering. Use when you need to fetch completed tasks without date range restrictions. Note: This action uses an undocumented Todoist API end
  • List FiltersTool to list all filters for the authenticated user. Use when you need to retrieve the current set of custom filters.
  • List LabelsTool to get all user labels with pagination support. Use when you need to retrieve labels from the user's Todoist account.
  • List Project CollaboratorsTool to get all collaborators for a given project with cursor-based pagination. Use when you need to retrieve the list of people who have access to a specific project.
  • List SectionsTool to get all active sections for the user, with optional filtering by project. Supports cursor-based pagination to handle large result sets.
  • List Workspace Active ProjectsTool to list all active workspace projects. Returns active projects that are visible to the user, including those not yet joined. For guest users, only joined workspace projects are returned.
  • Search ProjectsSearch active user projects by name with support for wildcards and pagination. Use when you need to find projects matching a specific name pattern.
  • Search SectionsTool to search active sections by name, optionally filtered by project. Use when you need to find sections matching a specific name pattern across all projects or within a specific project. Supports p
  • Get Comment (V1)Tool to retrieve a single comment by ID using the v1 API. Use when you need to fetch details of a specific comment.
  • Get ID MappingsTool to translate IDs between Todoist API v1 and v2. Use when you need to convert IDs between API versions for sections, tasks, comments, reminders, location_reminders, or projects.
  • Get Project PermissionsTool to retrieve all available roles and their associated actions in Todoist projects. Use when you need to understand what permissions different roles have in projects.
  • Get Section (v1 API)Tool to retrieve a specific section by its ID using Todoist v1 API. Use when you need section metadata from the v1 endpoint.
  • Get Task (API v1)Tool to retrieve a single active (non-completed) task by ID using API v1. Use when you need to fetch task details from the v1 endpoint.
  • Get Workspace Plan DetailsTool to retrieve details about a workspace's current plan and usage. Use when you need information about subscription status, member count, project limits, pricing, or trial status for a specific work
  • List ActivitiesTool to get activity logs from Todoist. Returns a paginated list of activity events for the user. Events can be filtered by object type (project, item, note), event type, and other criteria. Uses curs
  • List All Workspace InvitationsTool to return a list containing details of all pending invitations to a workspace. Use when you need to view all pending workspace invitations. This list is not paginated, and all workspace members c
  • List Archived ProjectsTool to get all archived projects from Todoist. Use when you need to retrieve archived projects with pagination support.
  • List Archived SectionsTool to retrieve all archived sections for a specific project in Todoist. Use when you need to access sections that have been archived in a project.
  • List Completed Tasks By Due DateTool to retrieve completed tasks within a specified due date range (up to 6 weeks). Use when you need to fetch completed tasks filtered by their original due dates rather than completion dates.
  • List Joinable WorkspacesTool to get workspaces the user can join. Use when you need to discover available workspaces that the authenticated user can join.
  • List Pending Workspace InvitationsTool to list pending invitation emails in a workspace. Use when you need to check which email invites are still pending acceptance in a workspace.
  • List Shared LabelsTool to retrieve shared label names from active tasks with pagination support. Use when you need to list labels across the workspace with optional filtering of personal labels.
  • List Workspace Archived ProjectsTool to get archived projects in a workspace. Use when you need to retrieve a list of archived projects for a specific workspace with optional pagination.
  • List Workspace InvitationsTool to list user emails with pending invitations to a workspace. Use when you need to check which email invites are still pending. The list is not paginated and accessible by all workspace members.
  • List Workspace UsersTool to list users in workspace(s). Use when you need to retrieve workspace members. Returns users from a specific workspace if workspace_id is provided, otherwise returns users from all workspaces th
  • Search LabelsTool to search user labels by name with case-insensitive matching. Use when you need to find specific labels by name pattern.

Held for approval by default (changes and sends)

Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 33 actions.

  • Add WorkspaceTool to create a new workspace in Todoist. Use when you need a separate workspace to organize projects. Generates UUID and temp_id automatically.
  • 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.
  • Bulk Create TasksCreate many tasks in one request using Todoist's Sync batching. Use when scaffolding projects or creating multiple tasks at once to reduce round trips.
  • 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.
  • 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
  • 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.
  • 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.
  • 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.
  • Create taskCreate a new task in Todoist using the unified API v1. This action allows users to create tasks with various parameters including content, due dates, priority, and more. The task can be created in a s
  • Delete CommentTool to delete a specific comment from Todoist by its ID. Use when you need to permanently remove a comment.
  • Delete Label (V1)Tool to delete a personal label using API v1. Use when you need to permanently remove a label by its ID. All instances of the label will be removed from tasks.
  • Delete Project (API v1)Tool to delete a project and all of its sections and tasks using Todoist API v1. Use when you need to permanently remove a project by its ID.
Show all 33
  • Delete Section (v1)Tool to delete a section and all tasks within it. Use when you need to permanently remove a section by its ID.
  • Delete TaskTool to delete a specific task from Todoist. Permanently removes the task and all its subtasks with no recycle bin or undo option. Confirm with the user before executing, especially for bulk deletions
  • Delete UploadTool to delete an uploaded file from Todoist. Use when you need to remove a file that was previously uploaded.
  • Invite Project CollaboratorTool to invite a collaborator to a Todoist project by email. Use when the user asks to share, invite someone to, or add a collaborator to a project. For workspace or team projects, you can optionally
  • Move TaskTool to move a task to another project, section, or parent task while preserving task identity and metadata. Use when you need to relocate a task without recreating it.
  • Quick Add TaskTool to add tasks using natural language parsing similar to the official Todoist clients. Use when you want to create a task quickly with natural language that includes dates, projects, labels, priori
  • Reopen Task (API v1)Tool to reopen a completed task in Todoist using API v1. Use when you need to restore a previously completed task. Any ancestor tasks or sections will also be marked as uncomplete and restored from hi
  • Reorder TasksReorder tasks deterministically by updating child_order in bulk via the Sync API item_reorder command. Use when you need to set specific ordering for tasks.
  • Unarchive Project (API v1)Tool to unarchive a previously archived Todoist project using API v1. Use when you need to reactivate an archived project, making it visible again for the initiating user (personal projects) or all wo
  • Update Project (API v1)Tool to update a project's properties using Todoist API v1. Use when you need to modify project settings like name, description, favorite status, color, or view style.
  • Update TaskTool to update an existing task's properties. Cannot change a task's project; to move a task, use TODOIST_CREATE_TASK then TODOIST_DELETE_TASK. Use when you need to modify a task's details after confi
  • Import Template Into Project By IDTool to import a template from Todoist's template gallery into an existing project. Use when you need to add structured tasks and sections from a pre-made template to an existing project.
  • Move Task (REST API)Tool to move a task to another project, section, or parent task using the REST API. Use when you need to relocate a task while preserving its identity and metadata.
  • Remove Shared Label (API v1)Tool to remove a shared label from all active tasks using API v1. Use when you need to remove a shared label created by a collaborator from your account.
  • Rename Shared Labels (API v1)Tool to rename a shared label across all active tasks using API v1. Use when you need to change the name of a shared label.
  • Todoist SyncTool to sync data with Todoist server, supporting both read and write operations. This is the central endpoint used by Todoist apps for all data synchronization. Use this action to: - Read multiple re
  • Update Comment (v1)Tool to update a comment by ID and return its content via v1 API. Use when you need to modify an existing comment's text using the v1 API endpoint.
  • Update Label (API v1)Tool to update an existing label using API v1. Use when you need to modify a label's name, color, order, or favorite status.
  • Update Notification SettingTool to update notification settings for the current user. Use when you need to enable or disable notifications for specific event types and channels.
  • Update Section (v1)Tool to update an existing section by its ID using Todoist v1 API. Use when you need to rename a section.
  • Update Workspace LogoTool to upload an image as the workspace logo or delete the existing logo. Use when you need to set or remove a workspace's branding image.

Changes wait in Needs you

Changes and sends in Todoist are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

How approvals work

Todoist questions

Can an agent change data in Todoist on its own?

Not by default. Changes and sends in Todoist are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.

What can an agent read in Todoist?

This connector lists 40 read actions. Reads run at once, without waiting for approval.

How does Todoist connect?

It connects with OAuth 2.0. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.

Bring Todoist to your agents.