Todoist

TODOIST 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 PROJECT

Tool to archive a Todoist project. Use when you need to hide a project for the user (personal projects) or all workspace users (workspace projects).

TODOIST ARCHIVE PROJECT2

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

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

This tool marks an existing task as completed in Todoist. It requires the `task_id` of the task to be closed.

TODOIST CLOSE TASK 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

Tool to create a new comment in Todoist. 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 COMMENT 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

Creates a new label.

TODOIST CREATE LABEL 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

Creates a new project in Todoist.

TODOIST CREATE PROJECT2

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

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

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.

TODOIST CREATE TASK

Create 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 specific project, section, or as a subtask of another task.

TODOIST DELETE COMMENT

Tool to delete a specific comment from Todoist by its ID. Use when you need to permanently remove a comment.

TODOIST DELETE LABEL

Tool to delete a specific label. Use when you need to permanently remove an unused label by its ID after confirming it's not in use. Example: "Delete label with ID 2298391482".

TODOIST 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.

TODOIST DELETE PERSONAL LABEL

Tool to delete a personal label. Use when you need to permanently remove a label, which will remove all instances of the label from associated tasks.

TODOIST DELETE PROJECT

Tool to delete a specific Todoist project. Use when you need to permanently remove a project by its ID.

TODOIST DELETE PROJECT2

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.

TODOIST DELETE SECTION

Tool to delete a specific section. Use when you need to permanently remove unused section by its ID after confirming it's not in use. Example: "Delete section with ID 82181370".

TODOIST DELETE SECTION2

Tool to delete a section and all tasks within it. Use when you need to permanently remove a section by its ID.

TODOIST DELETE TASK

Tool to delete a specific task from Todoist. Use when you need to permanently remove a task by its ID.

TODOIST DELETE TASK V1

Tool to delete a specific task from Todoist using API v1. Use when you need to permanently remove a task by its ID.

TODOIST DELETE UPLOAD

Tool to delete an uploaded file from Todoist. Use when you need to remove a file that was previously uploaded.

TODOIST EXPORT TEMPLATE AS FILE

Tool to export a Todoist project as a CSV template file. Use when you need to download a project template as a file for backup or sharing.

TODOIST EXPORT TEMPLATE AS URL

Tool 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.

TODOIST FILTER TASKS

Tool 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.

TODOIST GET ACTIVE TASK

Tool to retrieve a single active (non-completed) task by ID. Use when you need to fetch details of a specific active task.

TODOIST GET ALL COLLABORATORS

Tool to retrieve all collaborators of a shared project. Use when you need to see who has access to a shared Todoist project.

TODOIST GET ALL COMMENTS

This 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). Returns a JSON array of comment objects with details such as id, posted_at, content, and attachment information.

TODOIST GET ALL PERSONAL LABELS

Tool to retrieve all personal labels for the authenticated user. Use when you need to see all available labels in the user's account.

TODOIST GET ALL PROJECTS

Get all projects from a user's Todoist account. This tool retrieves all projects from the authenticated user's Todoist account. The response includes details like project ID, name, color, parent project, sharing status, and other metadata for each project.

TODOIST GET ALL SECTIONS

Tool to retrieve all the sections for a specific project in Todoist. Use when you need to list section structure within a project after selecting the project.

TODOIST GET ALL TASKS

Fetches all INCOMPLETE tasks from Todoist and returns their details. Supports cursor-based pagination. IMPORTANT LIMITATIONS: - This endpoint only returns active (incomplete) tasks - Cannot retrieve completed tasks - use a different endpoint for that - Filter queries using 'completed', '!completed', or 'completed after' will fail - Project/label references must use ACTUAL EXISTING names from the user's account - Arbitrary text in filters causes 400 errors - use 'search: keyword' for text search Common use cases: - Get all tasks: no filter - Get today's tasks: filter="today" - Get overdue tasks: filter="overdue" - Get tasks from specific project: filter="#ProjectName" (project must exist) - Get high priority tasks: filter="p1" - Search task content: filter="search: keyword" - Paginate results: use limit and cursor parameters

TODOIST GET BACKUPS

Tool to list all available backup archives for the user. Use when you need to retrieve and review all existing backups.

TODOIST GET COMMENT

Tool to retrieve details of a specific comment by its comment_id. Use when you need full information (content, timestamp, or attachment) about a known comment.

TODOIST 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.

TODOIST GET COMPLETED TASKS BY COMPLETION DATE

Tool 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 completion-date range to approximately 3 months between since and until parameters.

TODOIST GET ID MAPPINGS

Tool 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.

TODOIST GET LABEL

Tool to retrieve a specific label by its ID. Use when you need detailed info about a label after you have its ID.

TODOIST GET LABEL V1

Tool to retrieve a specific label by its ID using v1 API. Use when you need detailed info about a label after you have its ID.

TODOIST GET PERSONAL LABEL

Tool to retrieve a personal label by its ID. Use when you need to fetch details about a specific personal label.

TODOIST GET PRODUCTIVITY STATS

Tool 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 reports and analysis.

TODOIST GET PROJECT

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.

TODOIST GET PROJECT2

Tool to retrieve a specific project by its ID using Todoist API v1. Use when you need detailed project information including workspace-specific fields.

TODOIST GET PROJECT COLLABORATORS

Tool to get all collaborators of a shared project. Use when you need to retrieve the list of people who have access to a specific shared project.

TODOIST GET PROJECT FULL

Tool to retrieve full project data including all sections, tasks, and collaborators. Use when you need comprehensive project information beyond basic metadata.

TODOIST GET PROJECT PERMISSIONS

Tool 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.

TODOIST GET SECTION

Tool to retrieve a specific section by its ID. Use when you have a section ID and need its metadata before display or update.

TODOIST GET SECTION V1

Tool to retrieve a specific section by its ID using Todoist v1 API. Use when you need section metadata from the v1 endpoint.

TODOIST GET SHARED LABELS

Tool to retrieve all shared labels across the user's workspace. Use when you need to see labels that are shared within the workspace.

TODOIST GET SINGLE SECTION

Tool to retrieve a single section as a JSON object by its ID. Use when you have a section ID and need to fetch its details.

TODOIST GET SPECIAL BACKUPS

Tool to list special backup archives for the user. Use when you need to retrieve all project backups for the authenticated user after creating or managing projects.

TODOIST GET SYNC DATA

Tool to read sync data from the Todoist server. Use when you need to fetch user data including projects, tasks, labels, and other resources using the Sync API.

TODOIST GET TASK

Tool to retrieve a specific task by its ID. Use when you need to fetch all details of an existing task before processing or display.

TODOIST GET TASK2

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.

TODOIST GET USER

Tool to retrieve information about the currently authenticated user. Use when you need user details like email, name, preferences, karma, or subscription status.

TODOIST GET WORKSPACE PLAN DETAILS

Tool 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 workspace.

TODOIST IMPORT TEMPLATE INTO PROJECT BY ID

Tool 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.

TODOIST IMPORT TEMPLATE INTO PROJECT FROM FILE

Tool to import a CSV template into an existing Todoist project from a file. Use when you need to bulk-create tasks, sections, and notes from a template file.

TODOIST LIST ACTIVITIES

Tool 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 cursor-based pagination for efficient navigation through results.

TODOIST LIST ALL INVITATIONS WORKSPACES

Tool 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 can access it.

TODOIST LIST ARCHIVED PROJECTS

Tool to get all archived projects from Todoist. Use when you need to retrieve archived projects with pagination support.

TODOIST LIST ARCHIVED SECTIONS

Tool 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.

TODOIST LIST ARCHIVED WORKSPACE PROJECTS

Tool to list all archived projects in a workspace. Use when you need to retrieve archived workspace projects with optional filters or pagination.

TODOIST LIST COMMENTS

Tool to retrieve all comments for a given task or project using cursor-based pagination. Use when you need to fetch comments from Todoist tasks or projects. Exactly one of task_id or project_id must be provided.

TODOIST LIST COMPLETED TASKS

Tool 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 endpoint (/api/v1/tasks/completed). The endpoint is not officially documented but is confirmed to work based on runtime testing. The response schemas are based on actual API responses.

TODOIST LIST COMPLETED TASKS BY DUE DATE

Tool 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.

TODOIST LIST FILTERS

Tool to list all filters for the authenticated user. Use when you need to retrieve the current set of custom filters.

TODOIST LIST JOINABLE WORKSPACES

Tool to get workspaces the user can join. Use when you need to discover available workspaces that the authenticated user can join.

TODOIST LIST LABELS

Tool to get all user labels with pagination support. Use when you need to retrieve labels from the user's Todoist account.

TODOIST LIST PENDING WORKSPACE INVITATIONS

Tool to list pending invitation emails in a workspace. Use when you need to check which email invites are still pending acceptance in a workspace.

TODOIST LIST PROJECT COLLABORATORS

Tool 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.

TODOIST LIST SECTIONS

Tool to get all active sections for the user, with optional filtering by project. Supports cursor-based pagination to handle large result sets.

TODOIST LIST SHARED LABELS

Tool 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.

TODOIST LIST WORKSPACE ACTIVE PROJECTS

Tool 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.

TODOIST LIST WORKSPACE ARCHIVED PROJECTS

Tool 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.

TODOIST LIST WORKSPACE INVITATIONS

Tool 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.

TODOIST LIST WORKSPACE USERS

Tool 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 the authenticated user is part of. Not accessible by guests.

TODOIST MOVE TASK

Tool 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.

TODOIST 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.

TODOIST QUICK ADD TASK

Tool 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, priority, and other task attributes in a single text string.

TODOIST REMOVE SHARED LABELS

Tool to remove all instances of a shared label from tasks. Use when you need to remove a shared label created by a collaborator from your account.

TODOIST REMOVE SHARED LABEL 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.

TODOIST RENAME SHARED LABELS

Tool to rename a shared label across the workspace. Use when you need to change the name of a shared label created by a collaborator.

TODOIST RENAME SHARED LABELS 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 REOPEN TASK

Tool to reopen a completed task in Todoist. Use when you need to restore a previously completed task and its ancestors.

TODOIST REOPEN TASK2

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 history.

TODOIST REORDER TASKS

Reorder 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.

TODOIST SEARCH LABELS

Tool to search user labels by name with case-insensitive matching. Use when you need to find specific labels by name pattern.

TODOIST SEARCH PROJECTS

Search active user projects by name with support for wildcards and pagination. Use when you need to find projects matching a specific name pattern.

TODOIST SEARCH SECTIONS

Tool 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 pagination for large result sets.

TODOIST SYNC

Tool 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 resource types in a single request (projects, tasks, labels, etc.) - Perform batch write operations (create/update/delete up to 100 resources at once) - Implement efficient incremental sync using sync tokens - Execute complex multi-step operations in a single atomic request For read-only operations, pass sync_token and resource_types. For write operations, include commands array with the operations to execute. Commands support batching up to 100 operations per request.

TODOIST UNARCHIVE PROJECT

Tool to unarchive a Todoist project. Use when you need to reactivate an archived project for the user (personal projects) or all workspace users (workspace projects).

TODOIST UNARCHIVE PROJECT2

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 workspace users (workspace projects).

TODOIST UPDATE COMMENT

Tool to update a specific comment's content. Use when you need to correct or clarify an existing comment after confirming its ID and the new text.

TODOIST UPDATE COMMENT2

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.

TODOIST UPDATE LABEL

Tool to update a personal label's properties. Use when you need to modify a label's name, color, order, or favorite status.

TODOIST UPDATE LABEL V1 SECOND

Tool to update an existing label using API v1. Use when you need to modify a label's name, color, order, or favorite status.

TODOIST UPDATE NOTIFICATION SETTING

Tool to update notification settings for the current user. Use when you need to enable or disable notifications for specific event types and channels.

TODOIST UPDATE PERSONAL LABEL

Tool to update an existing personal label's properties. Use when you need to modify a label's name, color, order, or favorite status.

TODOIST UPDATE PROJECT

Tool to update a project's properties including name, color, favorite status, and view style. Use when you need to modify project settings after reviewing its current configuration.

TODOIST UPDATE PROJECT2

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.

TODOIST UPDATE SECTION

Tool to update a specific section's name. Use when you need to rename a section after confirming its ID.

TODOIST UPDATE SECTION2

Tool to update an existing section by its ID using Todoist v1 API. Use when you need to rename a section.

TODOIST UPDATE TASK

Tool to update an existing task's properties. Use when you need to modify a task's details after confirming its ID and new values.

TODOIST UPDATE TASK2

Tool to update an existing task's properties using Todoist API v1. Use when you need to modify task details after confirming the task ID and new values.

TODOIST UPDATE WORKSPACE LOGO

Tool 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.

TODOIST UPLOAD FILE

Tool to upload a file to Todoist. Use when you need to attach files to tasks or projects. The uploaded file can be later attached to comments or tasks using the returned file_url.

TODOIST CUSTOM GATHER CONTEXT

Get Todoist context snapshot: tasks and overdue items. Zero required parameters. Returns current task state for situational awareness.