- Category: model context protocol
- Auth: DCR_OAUTH
- Composio-managed OAuth available? No
- Tools: 47
- Triggers: 0
- Slug:
TODOIST_MCP - Version: 20261018_00
Tools
Add-comments
Add-comments
Add-filters
Add-filters
Add-labels
Add-labels
Add-projects
Add-projects
Add-reminders
Add-reminders
TODOIST_MCP_ADD_REMINDERSAdd reminders to tasks. Supports three types: “relative” (minutes before due), “absolute” (specific date/time), or “location” (geofence-triggered). Each reminder must specify a taskId.Input Parameters
Output
Add-sections
Add-sections
Add-tasks
Add-tasks
Analyze-project-health
Analyze-project-health
TODOIST_MCP_ANALYZE_PROJECT_HEALTHTrigger a new health analysis for a project. Use this when the health data is stale or you want a fresh assessment. The analysis may take time to complete — use get-project-health afterward to see updated results.Input Parameters
Output
Complete-tasks
Complete-tasks
Delete-object
Delete-object
TODOIST_MCP_DELETE_OBJECTDelete a project, section, task, comment, label, filter, reminder, or location_reminder by its ID. Projects can be deleted whether active or archived (find archived ones via find-projects with archivedStatus); note a workspace project must be archived before it can be deleted, while personal projects can be deleted regardless.Input Parameters
Output
Export-project-template
Export-project-template
TODOIST_MCP_EXPORT_PROJECT_TEMPLATEExport an existing project as a Todoist template, either as CSV content or as a shareable URL. Use it to duplicate a project, share its structure, or hand the CSV to import-project-template. To read a project rather than export it, use find-tasks instead — it returns structured tasks rather than raw CSV. Nothing is modified.Input Parameters
Output
Fetch
Fetch
Fetch-object
Fetch-object
TODOIST_MCP_FETCH_OBJECTFetch a single task, project, comment, or section by its ID. Use this when you have a specific object ID and want to retrieve its full details. Set includeChildren to also get its direct subtasks or sub-projects.Input Parameters
Output
Find-activity
Find-activity
TODOIST_MCP_FIND_ACTIVITYRetrieve activity logs to monitor and audit changes in Todoist. Shows events from all users by default (use initiatorId to filter by specific user). To answer what someone completed in a period, including recurring task occurrences, use objectType “task”, eventType “completed”, and dateFrom/dateTo. For a first-person question (“what did I get done”), also set initiatorId to the current user from user-info, or the answer includes collaborators’ completions. Track task completions, updates, deletions, project changes, and more with flexible filtering. Activity history availability and retention depend on the user plan.Input Parameters
Output
Find-comments
Find-comments
TODOIST_MCP_FIND_COMMENTSFind comments by task, project, or get a specific comment by ID. Exactly one of taskId, projectId, or commentId must be provided.Input Parameters
Output
Find-completed-tasks
Find-completed-tasks
TODOIST_MCP_FIND_COMPLETED_TASKSGet completed tasks in a date range. For “what did I complete/get done” questions, use find-activity instead — it reports completion events, including every occurrence of a recurring task, which this tool does not. since/until are optional and default to a 7-day window when omitted. Includes all collaborators by default. Person-specific queries (summaries, plans, reports) require responsibleUser.Input Parameters
Output
Find-filters
Find-filters
TODOIST_MCP_FIND_FILTERSList all personal filters or search for filters by name. Filters are saved custom views that use query syntax to organize tasks (e.g. “today & p1”, “#Work & overdue”).Input Parameters
Output
Find-labels
Find-labels
TODOIST_MCP_FIND_LABELSList personal labels and shared labels. Personal labels have full metadata (id, name, color, order, isFavorite) and support pagination and name search (partial, case insensitive). Shared labels are labels used on tasks shared with you — they are returned as names only (no IDs or metadata). When searching, all matching personal labels are fetched across all pages and returned as a single result set (limit and cursor are ignored). When not searching, personal labels are returned with pagination.Input Parameters
Output
Find-project-collaborators
Find-project-collaborators
TODOIST_MCP_FIND_PROJECT_COLLABORATORSFind Todoist users (collaborators, teammates) by name or email to look up their user ID. Use this whenever the user asks to find, look up, or identify a person — e.g. “find Carrie’s user ID”, “who is Ernesto”, “look up a user”. When projectId is omitted, searches across the collaborators of every shared project the authenticated user has access to, plus the authenticated user themselves — an empty result means the person is not a collaborator on any project you share with them, not necessarily that they do not exist in Todoist. When projectId is provided, searches only that project. Partial, case-insensitive match on name and email.Input Parameters
Output
Find-projects
Find-projects
TODOIST_MCP_FIND_PROJECTSList all projects or search for projects by name. By default only active projects are returned; use archivedStatus (‘archived’ or ‘all’) to include archived projects. When searching or when archivedStatus is ‘all’, all matching projects are returned (pagination is ignored). Otherwise projects are returned with pagination.Input Parameters
Output
Find-reminders
Find-reminders
Find-sections
Find-sections
TODOIST_MCP_FIND_SECTIONSSearch for sections by name or other criteria in a project. When searching, uses server-side search to avoid fetching all sections.Input Parameters
Output
Find-tasks
Find-tasks
TODOIST_MCP_FIND_TASKSFind tasks by text search, project/section/parent container, responsible user, labels, a raw Todoist filter string, or a saved filter by ID or name (filterIdOrName). At least one filter must be provided.Input Parameters
filter parameter, projectId, sectionId, or parentId.unassignedOrMe.Output
Find-tasks-by-date
Find-tasks-by-date
TODOIST_MCP_FIND_TASKS_BY_DATEGet tasks by date range. startDate=‘today’ includes overdue items. Default responsibleUserFiltering=‘unassignedOrMe’ excludes others’ tasks.Input Parameters
Output
Get-overview
Get-overview
TODOIST_MCP_GET_OVERVIEWGet a Markdown overview. If no projectId is provided, shows all projects with hierarchy and sections (useful for navigation). If projectId is provided, shows detailed overview of that specific project including all tasks grouped by sections.Input Parameters
Output
Get-productivity-stats
Get-productivity-stats
TODOIST_MCP_GET_PRODUCTIVITY_STATSGet comprehensive productivity statistics including daily/weekly completion breakdowns, goal streaks (current, last, max), karma score and trends, and historical karma data. Useful for productivity analysis and tracking goal progress. Reports counts, streaks and karma only, never the tasks themselves — for “what did I complete”, use find-activity.Output
Get-project-activity-stats
Get-project-activity-stats
Get-project-health
Get-project-health
TODOIST_MCP_GET_PROJECT_HEALTHGet a comprehensive health assessment for a project including completion progress, health status (EXCELLENT, ON_TRACK, AT_RISK, CRITICAL), and optional detailed context with project metrics and task-level data. Use includeContext=true for that full detail.Input Parameters
Output
Get-workspace-insights
Get-workspace-insights
TODOIST_MCP_GET_WORKSPACE_INSIGHTSGet aggregated health and progress insights across all projects in a workspace. Accepts workspace name or ID, with optional project ID filtering. Useful for a cross-project health overview.Input Parameters
Output
Import-project-template
Import-project-template
TODOIST_MCP_IMPORT_PROJECT_TEMPLATEImport a template into an existing project, adding its tasks, sections and comments to whatever is already there. Source it by template ID/URL or by passing CSV content from export-project-template. To start a new project from a template, create the project with add-projects first, then import into it. This writes immediately and cannot be undone, so only run it against a project the user named.Input Parameters
csvFileContent, not both.templateId, not both.Output
List-workspaces
List-workspaces
Manage-assignments
Manage-assignments
TODOIST_MCP_MANAGE_ASSIGNMENTSBulk assignment operations for multiple tasks. Supports assign, unassign, and reassign operations with atomic rollback on failures.Input Parameters
Output
Project-management
Project-management
Project-move
Project-move
Reorder-objects
Reorder-objects
TODOIST_MCP_REORDER_OBJECTSReorder sibling projects or sections, and optionally move projects to a new parent. For projects: set order to reorder siblings, and/or set parentId to move under a new parent (use “root” for top level). For sections: set order to reorder within a project.Input Parameters
Output
Reschedule-tasks
Reschedule-tasks
TODOIST_MCP_RESCHEDULE_TASKSReschedule tasks to new dates while preserving recurring schedules. Unlike update-tasks (which replaces the entire due string and can wipe recurrence), this tool changes only the date, keeping recurrence patterns intact. Use this when moving recurring tasks to a different date without altering their repeat pattern.Input Parameters
Output
Search
Search
Uncomplete-tasks
Uncomplete-tasks
Update-comments
Update-comments
Update-filters
Update-filters
Update-labels
Update-labels
TODOIST_MCP_UPDATE_LABELSUpdate one or more existing labels. Personal labels (identified by ID) can have their name, color, order, and favorite flag updated. Shared labels (identified by name) can only be renamed.Input Parameters
Output
Update-projects
Update-projects
Update-reminders
Update-reminders
TODOIST_MCP_UPDATE_REMINDERSUpdate existing reminders. Each reminder must specify its type (“relative”, “absolute”, or “location”) and ID. Only include fields that need to change.Input Parameters
Output
Update-sections
Update-sections
Update-tasks
Update-tasks
User-info
User-info