Reference

TODOIST_NEW_TASK_CREATED

Fires whenever someone creates a new task in Todoist. Use this to automatically sync tasks to other apps, send notifications, or log new work items.

List Activities

Retrieve a log of all activities and changes in your Todoist workspace, including task updates, project modifications, and note changes. This helps you track what's been done and who made changes across your tasks and projects.

Get Productivity Stats

Retrieve comprehensive productivity statistics including task completion rates, karma scores, and streaks to track your work performance and progress over time.

Get Backups

Retrieve a list of all backup archives available for your Todoist account, showing backup metadata without accessing live task data. Use this to verify backup availability and manage your backup history.

Get Special Backups

Retrieve a list of all backup archives created for your Todoist projects, allowing you to verify backup availability and manage your project recovery options.

Create Comment (API v1)

Add notes or comments to tasks or projects in Todoist to keep important information and context organized in one place. This helps you and your team stay aligned on task details and decisions.

Delete Comment

Permanently remove a comment from a Todoist task when you need to clean up outdated feedback or incorrect information. This helps keep your task discussions focused and relevant.

Get All Comments

Retrieve all comments attached to a specific task or project in Todoist to review feedback, updates, and discussions in one place. This helps you stay informed about all conversations related to your work items without switching between different views.

Get Comment (V1)

Retrieves a specific comment from a task to access its content and details. Useful when you need to reference or act on feedback from team members or collaborators within your task management system.

Delete Upload

Removes a file that was previously uploaded to Todoist, freeing up space and cleaning up your task attachments. Use this when you need to organize your task files or remove outdated documentation.

Filter Tasks

Retrieve tasks from Todoist that match specific criteria like priority, due date, or project. Use this to quickly find and organize tasks that meet your business needs without manually searching.

Create Label (API v1)

Create a new label in Todoist to organize and categorize your tasks for better project management and workflow organization.

Create Label (Deprecated)

Creates a new label to organize and categorize your tasks in Todoist. Labels help you group related tasks by project, priority, or type for better task management and filtering.

Delete Label (V1)

Permanently removes a label from your Todoist workspace, deleting it from all tasks that use it. Use this when you need to clean up outdated or unused label categories.

Get Personal Label

Retrieve detailed information about a specific personal label to view its properties and settings. This helps you organize and manage your task categorization system within your to-do list.

Create Project (API v1)

Creates a new project in Todoist to organize your tasks and team workflows by topic or client.

Get all projects

Retrieves all active projects from your Todoist account, providing project details like names, colors, and organizational structure. Use this to get a complete overview of your task management setup for automation, reporting, or integration purposes.

Archive Project (API v1)

Move a completed or inactive project out of your active workspace to keep your task list organized and focused on current work.

Create Project (Deprecated)

Creates a new project in Todoist to organize and categorize your tasks. Use the returned project ID to manage and reference this project in future operations.

Delete Project (API v1)

Permanently removes a project and all its associated sections and tasks from your Todoist workspace. Use this when you no longer need a project and want to clean up your task management system.

Get Full Project Data

Retrieve complete project information including all sections, tasks, and team members in one request. Use this when you need a comprehensive view of your project's structure and progress.

Get Project (API v1)

Retrieves detailed information about a specific Todoist project using its ID, allowing you to access project metadata like name, color, and settings without loading all projects.

Get Project Permissions

Retrieve information about user roles and the specific actions each role can perform within Todoist projects. This helps you understand collaboration capabilities and plan project sharing strategies effectively.

Invite Project Collaborator

Send an invitation to a team member or client to collaborate on a specific Todoist project, allowing them to view, edit, and manage tasks together.

List Archived Projects

Retrieve all archived projects from your Todoist workspace with pagination support. This helps you access previously completed projects for reference or to restore them if needed.

List Archived Workspace Projects

Retrieve all archived projects in your Todoist workspace to access completed or inactive projects that have been hidden from your main project list. This is useful when you need to review, restore, or reference projects you've finished with.

Create Section (API v1)

Organize your project tasks by creating a new section to group related items under a specific heading. This helps you structure large projects and make task management more intuitive.

Create Section (Deprecated)

Organize your project tasks by creating new sections to group related work under different categories or phases. This helps you structure large projects into manageable segments for better visibility and workflow management.

Delete Section (v1)

Permanently removes a section from your Todoist project, including all tasks contained within it, helping you clean up outdated or completed project categories.

Get Section (v1 API)

Retrieves detailed information about a specific section in your Todoist workspace, including its name, project association, and metadata. Use this to access section details for organizing and managing your task hierarchy.

List Archived Sections

Retrieve all archived sections within a specific project to review or restore previously organized task groupings that are no longer active.

Get ID Mappings

Converts task and project identifiers between different Todoist API versions so you can seamlessly migrate data or integrate with multiple systems without losing references.

Bulk Create Tasks

Add multiple tasks to your Todoist projects in a single request, saving time and keeping your task list organized when setting up new workflows or projects.

Close Task (API v1)

Mark a task as completed in your Todoist task list, helping you track progress and keep your to-do list current. This is useful for logging finished work and maintaining an accurate view of what's been accomplished.

Create task

Add a new task to your Todoist project with customizable details like due dates, priority levels, and assigned sections. This helps you capture and organize work items as they come up throughout your day.

Delete Task

Permanently removes a task and all its subtasks from Todoist. Use this when you need to clean up completed work, cancel projects, or remove items that are no longer relevant.

Get All Tasks

Retrieves all incomplete tasks from Todoist with their full details, allowing you to view your current workload and filter tasks by priority, project, due date, or search terms. This helps you stay organized and track what needs to be done.

Close Task (Deprecated)

Marks a task as completed in your Todoist task list, removing it from your active workload. This is useful for tracking task progress and keeping your to-do list organized as you complete work.

Delete Task (API v1)

Permanently removes a task from your Todoist account. Use this when you need to delete completed, cancelled, or obsolete tasks to keep your task list clean and organized.

Get Completed Tasks By Completion Date

Retrieves tasks you've completed within a specified date range, allowing you to review your work history and track productivity over time. Perfect for generating reports, analyzing work patterns, and confirming task completion for clients or yourself.

Get Task (API v1)

Retrieve detailed information about a specific task from your Todoist account, including its title, description, due date, and other metadata.

Get Task (Deprecated)

Retrieve detailed information about a specific task in Todoist by its ID, including title, description, due date, and priority level. Use this when you need to access task details for processing, display, or integration with other tools.

List Completed Tasks

Retrieve all your completed tasks from Todoist, with the ability to filter by specific projects to see what work has been finished. This helps you track productivity and understand task completion patterns across your work.

Export Template As File

Download a Todoist project as a CSV file to create reusable templates or maintain backups of your task structures and workflows.

Export Template As URL

Generate a shareable URL for a Todoist project that can be used as a reusable template, allowing others to quickly set up the same project structure with a single click.

Import Template Into Project By ID

Apply pre-designed task templates from Todoist's gallery into your existing projects, instantly creating structured workflows with predefined tasks and sections. This saves time by eliminating the need to manually set up recurring task structures.

Import Template Into Project From File

Import tasks, sections, and notes into a Todoist project from a CSV template file, enabling you to quickly set up project structures without manual data entry.

Get User

Retrieve information about the authenticated user including email, name, preferences, and subscription details. Useful for personalizing workflows or verifying account status.

Add Workspace

Create a new workspace in Todoist to organize and manage separate projects or teams independently. This lets you maintain multiple project collections without mixing tasks across different business areas.

Get Workspace Plan Details

Retrieve your workspace's subscription plan details, including current tier, member count, project limits, and usage information. Use this to understand your plan capabilities and whether you need to upgrade.

List All Workspace Invitations

Retrieve all pending invitations sent to your Todoist workspace so you can see who's been invited and manage team onboarding.

List Completed Tasks By Due Date

Tool to retrieve completed tasks within a specified due date range (up to 6 weeks).

List Filters

Tool to list all filters for the authenticated user.

List Joinable Workspaces

Tool to get workspaces the user can join.

List Labels

Tool to get all user labels with pagination support.

List Pending Workspace Invitations

Tool to list pending invitation emails in a workspace.

List Project Collaborators

Tool to get all collaborators for a given project with cursor-based pagination.

List Sections

Tool to get all active sections for the user, with optional filtering by project.

List Shared Labels

Tool to retrieve shared label names from active tasks with pagination support.

List Workspace Active Projects

Tool to list all active workspace projects.

List Workspace Archived Projects

Tool to get archived projects in a workspace.

List Workspace Invitations

Tool to list user emails with pending invitations to a workspace.

List Workspace Users

Tool to list users in workspace(s).

Move Task

Tool to move a task to another project, section, or parent task while preserving task identity and metadata.

Move Task (REST API)

Tool to move a task to another project, section, or parent task using the REST API.

Quick Add Task

Tool to add tasks using natural language parsing similar to the official Todoist clients.

Remove Shared Label (API v1)

Tool to remove a shared label from all active tasks using API v1.

Rename Shared Labels (API v1)

Tool to rename a shared label across all active tasks using API v1.

Reopen Task (API v1)

Tool to reopen a completed task in Todoist using API v1.

Reorder Tasks

Reorder tasks deterministically by updating childorder in bulk via the Sync API itemreorder command.

Search Labels

Tool to search user labels by name with case-insensitive matching.

Search Projects

Search active user projects by name with support for wildcards and pagination.

Search Sections

Tool to search active sections by name, optionally filtered by project.

Todoist Sync

Tool to sync data with Todoist server, supporting both read and write operations.

Unarchive Project (API v1)

Tool to unarchive a previously archived Todoist project using API v1.

Update Comment (v1)

Tool to update a comment by ID and return its content via v1 API.

Update Label (API v1)

Tool to update an existing label using API v1.

Update Notification Setting

Tool to update notification settings for the current user.

Update Project (API v1)

Tool to update a project's properties using Todoist API v1.

Update Project (Deprecated)

DEPRECATED: Use TODOISTTODOISTUPDATEPROJECT2 instead.

Update Section (Deprecated)

DEPRECATED: Use TODOISTTODOISTUPDATESECTION2 instead.

Update Section (v1)

Tool to update an existing section by its ID using Todoist v1 API.

Update Task

Tool to update an existing task's properties.

Update Workspace Logo

Tool to upload an image as the workspace logo or delete the existing logo.

Upload File

Tool to upload a file to Todoist.