> ## Documentation Index > Fetch the complete documentation index at: https://docs.boxd.sh/llms.txt > Use this file to discover all available pages before exploring further. # 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 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 `todoist` · **84 tools** · **1 triggers** ## Connect it ```bash theme={"theme":"github-dark"} run auth todoist run auth todoist --scope team # shared with the organization ``` Or from the [Integrations page](https://app.boxd.sh/integrations) in the console. See [Connections](/guides/integrations/connections) for personal versus shared, and who may remove one. ## Use it ```bash theme={"theme":"github-dark"} run todoist # common commands run todoist --all # every command ``` ```ts theme={"theme":"github-dark"} import { todoist } from "@boxd/run"; ``` ## Common tools | Tool | What it does | | ------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `add-workspace` | Tool to create a new workspace in Todoist. Use when you need a separate workspace to organize projects. | | `archive-project2` | Tool to archive a project using Todoist API v1. For personal projects, archives it for the initiating user. | | `bulk-create-tasks` | Create many tasks in one request using Todoist's Sync batching. | | `close-task` | DEPRECATED: Use TODOIST\_CLOSE\_TASK\_V1 instead. This tool marks an existing task as completed in 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. | | `create-comment-v1` | Tool to create a new comment on a project or task using Todoist API v1. | | `create-label` | DEPRECATED: Use TODOIST\_CREATE\_LABEL\_V1 instead. Creates a new label. | | `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. | | `create-project` | DEPRECATED: Use TODOIST\_TODOIST\_CREATE\_PROJECT2 instead. Creates a new project in Todoist. | | `create-project2` | Tool to create a new project in Todoist using the unified API v1. | | `create-section` | DEPRECATED: Use TODOIST\_CREATE\_SECTION\_V1 instead. Tool to create a new section within a specific project. | | `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. | | `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. | | `delete-comment` | Tool 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. | | `delete-project2` | Tool to delete a project and all of its sections and tasks using Todoist API v1. | | `delete-section2` | Tool to delete a section and all tasks within it. Use when you need to permanently remove a section by its ID. | | `delete-task` | Tool to delete a specific task from Todoist. Permanently removes the task and all its subtasks with no recycle bin or undo option. | | `delete-task-v1` | DEPRECATED: Use TODOIST\_DELETE\_TASK instead. Tool to delete a specific task from Todoist using API v1. | | `delete-upload` | Tool to delete an uploaded file from Todoist. Use when you need to remove a file that was previously uploaded. | | `export-template-as-url` | Tool to export a Todoist project as a shareable template URL. | | `filter-tasks` | Tool to get all tasks matching the filter. Use when you need to retrieve tasks based on specific filter criteria. | | `get-all-comments` | This tool retrieves all comments associated with a specific task or project in Todoist. | | `get-all-projects` | Get all projects from a user's Todoist account. Retrieves all active (non-archived) projects; use TODOIST\_LIST\_ARCHIVED\_WORKSPACE\_PROJECTS for archived ones. | | `get-all-tasks` | Fetches all INCOMPLETE tasks from Todoist and returns their details. | | Tool | What it does | | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `add-workspace` | Tool to create a new workspace in Todoist. Use when you need a separate workspace to organize projects. | | `archive-project2` | Tool to archive a project using Todoist API v1. For personal projects, archives it for the initiating user. | | `bulk-create-tasks` | Create many tasks in one request using Todoist's Sync batching. | | `close-task` | DEPRECATED: Use TODOIST\_CLOSE\_TASK\_V1 instead. This tool marks an existing task as completed in 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. | | `create-comment-v1` | Tool to create a new comment on a project or task using Todoist API v1. | | `create-label` | DEPRECATED: Use TODOIST\_CREATE\_LABEL\_V1 instead. Creates a new label. | | `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. | | `create-project` | DEPRECATED: Use TODOIST\_TODOIST\_CREATE\_PROJECT2 instead. Creates a new project in Todoist. | | `create-project2` | Tool to create a new project in Todoist using the unified API v1. | | `create-section` | DEPRECATED: Use TODOIST\_CREATE\_SECTION\_V1 instead. Tool to create a new section within a specific project. | | `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. | | `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. | | `delete-comment` | Tool 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. | | `delete-project2` | Tool to delete a project and all of its sections and tasks using Todoist API v1. | | `delete-section2` | Tool to delete a section and all tasks within it. Use when you need to permanently remove a section by its ID. | | `delete-task` | Tool to delete a specific task from Todoist. Permanently removes the task and all its subtasks with no recycle bin or undo option. | | `delete-task-v1` | DEPRECATED: Use TODOIST\_DELETE\_TASK instead. Tool to delete a specific task from Todoist using API v1. | | `delete-upload` | Tool to delete an uploaded file from Todoist. Use when you need to remove a file that was previously uploaded. | | `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. | | `export-template-as-url` | Tool to export a Todoist project as a shareable template URL. | | `filter-tasks` | Tool to get all tasks matching the filter. Use when you need to retrieve tasks based on specific filter criteria. | | `get-all-comments` | This tool retrieves all comments associated with a specific task or project in Todoist. | | `get-all-projects` | Get all projects from a user's Todoist account. Retrieves all active (non-archived) projects; use TODOIST\_LIST\_ARCHIVED\_WORKSPACE\_PROJECTS for archived ones. | | `get-all-tasks` | Fetches all INCOMPLETE tasks from Todoist and returns their details. | | `get-backups` | Tool 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... | | `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-completed-tasks-by-completion-date` | Tool to retrieve completed tasks within a specified completion date window. | | `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... | | `get-personal-label` | Tool to retrieve a personal label by its ID. Use when you need to fetch details about a specific personal label. | | `get-productivity-stats` | Tool to retrieve comprehensive productivity statistics for the authenticated user. | | `get-project` | Tool to retrieve a specific project by its ID using Todoist API v1. | | `get-project-full` | Tool to retrieve full project data including all sections, tasks, and collaborators. | | `get-project-permissions` | Tool to retrieve all available roles and their associated actions in Todoist projects. | | `get-section-v1` | Tool to retrieve a specific section by its ID using Todoist v1 API. | | `get-special-backups` | Tool to list special backup archives for the authenticated user's projects. | | `get-task` | DEPRECATED: Use TODOIST\_GET\_TASK2 instead. Tool to retrieve a specific task by its ID. | | `get-task2` | Tool to retrieve a single active (non-completed) task by ID using API v1. | | `get-user` | Tool to retrieve information about the currently authenticated user. | | `get-workspace-plan-details` | Tool to retrieve details about a workspace's current plan and usage. | | `import-template-into-project-by-id` | Tool to import a template from Todoist's template gallery into an existing project. | | `import-template-into-project-from-file` | Tool to import a CSV template into an existing Todoist project from a file. | | `invite-project-collaborator` | Tool to invite a collaborator to a Todoist project by email. | | `list-activities` | Tool to get activity logs from Todoist. Returns a paginated list of activity events for the user. | | `list-all-invitations-workspaces` | Tool to return a list containing details of all pending invitations to a workspace. | | `list-archived-projects` | Tool to get all archived projects from Todoist. Use when you need to retrieve archived projects with pagination support. | | `list-archived-sections` | Tool to retrieve all archived sections for a specific project in Todoist. | | `list-archived-workspace-projects` | Tool to list all archived projects in a workspace. Archived projects are excluded from TODOIST\_GET\_ALL\_PROJECTS; combine both tools when a complete... | | `list-completed-tasks` | Tool to retrieve all completed tasks with optional project filtering. | | `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. Use when you need to retrieve the current set of custom filters. | | `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. | | `list-labels` | Tool to get all user labels with pagination support. Use when you need to retrieve labels from the user's Todoist account. | | `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. | | `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. Returns active projects that are visible to the user, including those not yet joined. | | `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. | | `list-workspace-invitations` | Tool to list user emails with pending invitations to a workspace. | | `list-workspace-users` | Tool to list users in workspace(s). Use when you need to retrieve workspace members. | | `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-v1` | Tool to remove a shared label from all active tasks using API v1. | | `rename-shared-labels-v1` | Tool to rename a shared label across all active tasks using API v1. | | `reopen-task2` | Tool to reopen a completed task in Todoist using API v1. Use when you need to restore a previously completed task. | | `reorder-tasks` | Reorder tasks deterministically by updating child\_order in bulk via the Sync API item\_reorder 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. | | `sync` | Tool to sync data with Todoist server, supporting both read and write operations. | | `unarchive-project2` | Tool to unarchive a previously archived Todoist project using API v1. | | `update-comment2` | Tool to update a comment by ID and return its content via v1 API. | | `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. | | `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. | | `update-project` | DEPRECATED: Use TODOIST\_TODOIST\_UPDATE\_PROJECT2 instead. Tool to update a project's properties including name, color, favorite status, and view style. | | `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. | | `update-section` | DEPRECATED: Use TODOIST\_TODOIST\_UPDATE\_SECTION2 instead. Tool to update a specific section's name. | | `update-section2` | Tool to update an existing section by its ID using Todoist v1 API. | | `update-task` | Tool 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. | | `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. Use when you need to attach files to tasks or projects. | ## Triggers (1) Subscribe with `.on(...)` in a script. A trigger with required configuration takes it as the second argument. | Trigger | Needs | What fires it | | ---------------- | ------- | -------------------------------------------- | | New Task Created | nothing | Trigger when a new task is added to Todoist. | [Open Todoist in the console →](https://app.boxd.sh/integrations/detail/todoist)