Email & Productivity
✅ Todoist integration
Access levels: Read-only · Read + write · Full access · Verified
Email & Productivity
Access levels: Read-only · Read + write · Full access · Verified
Connect Todoist once and every agent in your squad can work in it for you, with exactly as much access as you decide to give, and a receipt for every call it makes.
You can change an account's access level any time under Manage. It applies instantly, no re-authorization. If the connection ever expires, the card shows Reconnect; one click re-authorizes the same account with the same settings.
Multiple accounts: connect as many as you need (say, yours and a client's). One is primary. Agents use it unless a mission says otherwise.
The level you pick at connect time is enforced on our side for every agent call: an agent can never do more than the level allows, no matter what it's asked.
| Level | What it allows | |
|---|---|---|
| Read-only | Read tasks and projects. Cannot create, edit, or delete. | |
| Read + write | Read tasks and create new ones. | Recommended |
| Full access | Read, create, edit, and delete tasks and projects. |
On top of the connection's level, every agent can be individually allowed, scoped down, or denied for this app from the Integrations page. Deny an agent and it doesn't even see the connection.
The 84 tools agents use in Todoist through Mission Control, and the lowest access level that includes each. Agents discover these themselves. You never have to name a tool; asking in plain language is enough.
| Tool | What it does | Access level |
|---|---|---|
Add workspaceTODOIST_ADD_WORKSPACE | Create a new workspace in Todoist. Use when you need a separate workspace to organize projects. Generates UUID and temp_id automatically. | Read + write, Full access |
Archive project2TODOIST_ARCHIVE_PROJECT2 | 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. | Read + write, Full access |
Bulk create tasksTODOIST_BULK_CREATE_TASKS | Create many tasks in one request using Todoist's Sync batching. | Read + write, Full access |
Close taskTODOIST_CLOSE_TASK | DEPRECATED: Use TODOIST_CLOSE_TASK_V1 instead. | Full access |
Close task v1TODOIST_CLOSE_TASK_V1 | Close (complete) a task in Todoist using API v1. | Read + write, Full access |
Create comment v1TODOIST_CREATE_COMMENT_V1 | Create a new comment on a project or task using Todoist API v1. | Read + write, Full access |
Create labelTODOIST_CREATE_LABEL | DEPRECATED: Use TODOIST_CREATE_LABEL_V1 instead. | Read + write, Full access |
Create label v1TODOIST_CREATE_LABEL_V1 | Create a new personal label using API v1. Use when you need to add a new label to organize tasks. | Read + write, Full access |
Create projectTODOIST_CREATE_PROJECT | DEPRECATED: Use TODOIST_TODOIST_CREATE_PROJECT2 instead. | Read + write, Full access |
Create project2TODOIST_CREATE_PROJECT2 | Create a new project in Todoist using the unified API v1. | Read + write, Full access |
Create sectionTODOIST_CREATE_SECTION | DEPRECATED: Use TODOIST_CREATE_SECTION_V1 instead. | Read + write, Full access |
Create section v1TODOIST_CREATE_SECTION_V1 | Create a new section within a project using API v1. | Read + write, Full access |
Create taskTODOIST_CREATE_TASK | Create a new task in Todoist using the unified API v1. | Read + write, Full access |
Delete commentTODOIST_DELETE_COMMENT | Delete a specific comment from Todoist by its ID. | Full access |
Delete label v1TODOIST_DELETE_LABEL_V1 | 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. | Full access |
Delete project2TODOIST_DELETE_PROJECT2 | Delete a project and all of its sections and tasks using Todoist API v1. | Full access |
Delete section2TODOIST_DELETE_SECTION2 | Delete a section and all tasks within it. Use when you need to permanently remove a section by its ID. | Full access |
Delete taskTODOIST_DELETE_TASK | 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. | Full access |
Delete task v1TODOIST_DELETE_TASK_V1 | DEPRECATED: Use TODOIST_DELETE_TASK instead. | Full access |
Delete uploadTODOIST_DELETE_UPLOAD | Delete an uploaded file from Todoist. Use when you need to remove a file that was previously uploaded. | Full access |
Export template as fileTODOIST_EXPORT_TEMPLATE_AS_FILE | Export a Todoist project as a CSV template file. | All levels |
Export template as urlTODOIST_EXPORT_TEMPLATE_AS_URL | Export a Todoist project as a shareable template URL. | All levels |
Filter tasksTODOIST_FILTER_TASKS | 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. | All levels |
Get all commentsTODOIST_GET_ALL_COMMENTS | This tool retrieves all comments associated with a specific task or project in Todoist. | All levels |
Get all projectsTODOIST_GET_ALL_PROJECTS | Get all projects from a user's Todoist account. | All levels |
Get all tasksTODOIST_GET_ALL_TASKS | Fetches all INCOMPLETE tasks from Todoist and returns their details. | All levels |
Get backupsTODOIST_GET_BACKUPS | List all available backup archives for the user. | All levels |
Get comment v1TODOIST_GET_COMMENT_V1 | Retrieve a single comment by ID using the v1 API. | All levels |
Get completed tasks by completion dateTODOIST_GET_COMPLETED_TASKS_BY_COMPLETION_DATE | Retrieve completed tasks within a specified completion date window. | All levels |
Get id mappingsTODOIST_GET_ID_MAPPINGS | Translate IDs between Todoist API v1 and v2. | All levels |
Get personal labelTODOIST_GET_PERSONAL_LABEL | Retrieve a personal label by its ID. Use when you need to fetch details about a specific personal label. | All levels |
Get productivity statsTODOIST_GET_PRODUCTIVITY_STATS | Retrieve comprehensive productivity statistics for the authenticated user. | All levels |
Get projectTODOIST_GET_PROJECT | Retrieve a specific project by its ID using Todoist API v1. | All levels |
Get project fullTODOIST_GET_PROJECT_FULL | Retrieve full project data including all sections, tasks, and collaborators. | All levels |
Get project permissionsTODOIST_GET_PROJECT_PERMISSIONS | Retrieve all available roles and their associated actions in Todoist projects. | All levels |
Get section v1TODOIST_GET_SECTION_V1 | Retrieve a specific section by its ID using Todoist v1 API. | All levels |
Get special backupsTODOIST_GET_SPECIAL_BACKUPS | List special backup archives for the authenticated user's projects. | All levels |
Get taskTODOIST_GET_TASK | DEPRECATED: Use TODOIST_GET_TASK2 instead. | All levels |
Get task2TODOIST_GET_TASK2 | Retrieve a single active (non-completed) task by ID using API v1. | All levels |
Get userTODOIST_GET_USER | Retrieve information about the currently authenticated user. | All levels |
Get workspace plan detailsTODOIST_GET_WORKSPACE_PLAN_DETAILS | Retrieve details about a workspace's current plan and usage. | All levels |
Import template into project by idTODOIST_IMPORT_TEMPLATE_INTO_PROJECT_BY_ID | Import a template from Todoist's template gallery into an existing project. | Read + write, Full access |
Import template into project from fileTODOIST_IMPORT_TEMPLATE_INTO_PROJECT_FROM_FILE | Import a CSV template into an existing Todoist project from a file. | Read + write, Full access |
Invite project collaboratorTODOIST_INVITE_PROJECT_COLLABORATOR | Invite a collaborator to a Todoist project by email. | Read + write, Full access |
List activitiesTODOIST_LIST_ACTIVITIES | 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 eff… | All levels |
List all invitations workspacesTODOIST_LIST_ALL_INVITATIONS_WORKSPACES | Return a list containing details of all pending invitations to a workspace. | All levels |
List archived projectsTODOIST_LIST_ARCHIVED_PROJECTS | Get all archived projects from Todoist. Use when you need to retrieve archived projects with pagination support. | All levels |
List archived sectionsTODOIST_LIST_ARCHIVED_SECTIONS | Retrieve all archived sections for a specific project in Todoist. | All levels |
List archived workspace projectsTODOIST_LIST_ARCHIVED_WORKSPACE_PROJECTS | List all archived projects in a workspace. | All levels |
List completed tasksTODOIST_LIST_COMPLETED_TASKS | Retrieve all completed tasks with optional project filtering. | All levels |
List completed tasks by due dateTODOIST_LIST_COMPLETED_TASKS_BY_DUE_DATE | Retrieve completed tasks within a specified due date range (up to 6 weeks). | All levels |
List filtersTODOIST_LIST_FILTERS | List all filters for the authenticated user. | All levels |
List joinable workspacesTODOIST_LIST_JOINABLE_WORKSPACES | Get workspaces the user can join. Use when you need to discover available workspaces that the authenticated user can join. | All levels |
List labelsTODOIST_LIST_LABELS | Get all user labels with pagination support. | All levels |
List pending workspace invitationsTODOIST_LIST_PENDING_WORKSPACE_INVITATIONS | List pending invitation emails in a workspace. | All levels |
List project collaboratorsTODOIST_LIST_PROJECT_COLLABORATORS | Get all collaborators for a given project with cursor-based pagination. | All levels |
List sectionsTODOIST_LIST_SECTIONS | Get all active sections for the user, with optional filtering by project. | All levels |
List shared labelsTODOIST_LIST_SHARED_LABELS | Retrieve shared label names from active tasks with pagination support. | All levels |
List workspace active projectsTODOIST_LIST_WORKSPACE_ACTIVE_PROJECTS | 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. | All levels |
List workspace archived projectsTODOIST_LIST_WORKSPACE_ARCHIVED_PROJECTS | Get archived projects in a workspace. Use when you need to retrieve a list of archived projects for a specific workspace with optional pagination. | All levels |
List workspace invitationsTODOIST_LIST_WORKSPACE_INVITATIONS | List user emails with pending invitations to a workspace. | All levels |
List workspace usersTODOIST_LIST_WORKSPACE_USERS | 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 par… | All levels |
Move taskTODOIST_MOVE_TASK | Move a task to another project, section, or parent task while preserving task identity and metadata. | Read + write, Full access |
Move task rest apiTODOIST_MOVE_TASK_REST_API | Move a task to another project, section, or parent task using the REST API. | Read + write, Full access |
Quick add taskTODOIST_QUICK_ADD_TASK | Add tasks using natural language parsing similar to the official Todoist clients. | Read + write, Full access |
Remove shared label v1TODOIST_REMOVE_SHARED_LABEL_V1 | Remove a shared label from all active tasks using API v1. | Full access |
Rename shared labels v1TODOIST_RENAME_SHARED_LABELS_V1 | Rename a shared label across all active tasks using API v1. | Read + write, Full access |
Reopen task2TODOIST_REOPEN_TASK2 | Reopen a completed task in Todoist using API v1. | Read + write, Full access |
Reorder tasksTODOIST_REORDER_TASKS | Reorder tasks deterministically by updating child_order in bulk via the Sync API item_reorder command. | Read + write, Full access |
Search labelsTODOIST_SEARCH_LABELS | Search user labels by name with case-insensitive matching. | All levels |
Search projectsTODOIST_SEARCH_PROJECTS | Search active user projects by name with support for wildcards and pagination. | All levels |
Search sectionsTODOIST_SEARCH_SECTIONS | Search active sections by name, optionally filtered by project. | All levels |
SyncTODOIST_SYNC | Sync data with Todoist server, supporting both read and write operations. | Full access |
Unarchive project2TODOIST_UNARCHIVE_PROJECT2 | Unarchive a previously archived Todoist project using API v1. | Read + write, Full access |
Update comment2TODOIST_UPDATE_COMMENT2 | Update a comment by ID and return its content via v1 API. | Read + write, Full access |
Update label v1 secondTODOIST_UPDATE_LABEL_V1_SECOND | Update an existing label using API v1. Use when you need to modify a label's name, color, order, or favorite status. | Read + write, Full access |
Update notification settingTODOIST_UPDATE_NOTIFICATION_SETTING | Update notification settings for the current user. | Read + write, Full access |
Update projectTODOIST_UPDATE_PROJECT | DEPRECATED: Use TODOIST_TODOIST_UPDATE_PROJECT2 instead. | Read + write, Full access |
Update project2TODOIST_UPDATE_PROJECT2 | Update a project's properties using Todoist API v1. | Read + write, Full access |
Update sectionTODOIST_UPDATE_SECTION | DEPRECATED: Use TODOIST_TODOIST_UPDATE_SECTION2 instead. | Read + write, Full access |
Update section2TODOIST_UPDATE_SECTION2 | Update an existing section by its ID using Todoist v1 API. | Read + write, Full access |
Update taskTODOIST_UPDATE_TASK | 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 confirming its ID and new values. | Read + write, Full access |
Update workspace logoTODOIST_UPDATE_WORKSPACE_LOGO | Upload an image as the workspace logo or delete the existing logo. | Full access |
Upload fileTODOIST_UPLOAD_FILE | 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. | Read + write, Full access |
Just ask in plain language: “check Todoist for …”, “create … in Todoist”, “every Monday, … ”, and the agent finds the right tool, runs it, and reports back with a receipt in your Runs ledger. Anything outward-facing (sending, posting, publishing) that a mission didn't clearly authorize comes back to you as a ticket first.
| Agent says | What's happening | Fix |
|---|---|---|
| "Todoist isn't connected" | No active connection (or this agent is denied) | Connect on the Integrations page; check the agent's per-app policy |
| "The connection has expired" | Todoist ended the authorization (they all do periodically) | Click Reconnect on the account, same settings, one click |
| "I'm not allowed to do that" | The action is above the account's access level, or the agent is scoped down | Raise the level under Manage, or adjust that agent's policy |
| It did something unexpected | The ask was ambiguous (e.g. matched an existing item) | Be explicit, "create a NEW …", and give agents a working folder where relevant |