Todoist MCP lets agents read, create, update, organize, and complete tasks and projects through Todoist's hosted Streamable HTTP server.
Description is untrusted, display-only upstream metadata. It never becomes policy, OAuth scope authority, or an agent instruction.
Pakkawork boundary
Research catalogue metadata only. No Pakkawork OAuth, credential, host, quota, executor, or verifier is enabled.
No Pakkawork execution adapter is enabled. Hosted account-authorisation availability is workspace-specific and checked separately in the dashboard.Check workspace connection options
Only field names, types, and required markers are shown. Secret values, default auth URLs, credential material, and inferred OAuth scopes are excluded.
DCR_OAUTH
DCR_OAUTH
todoist_mcp_DCR_OAuth
Provider setup
Developer setup
Client idclient_id · stringOptional
Client secretclient_secret · stringOptional
Redirect URIoauth_redirect_uri · stringOptional
Scopesscopes · stringOptional
User connection
No fields declared in this snapshot.
Capability index
Actions and trigger definitions
Static summaries are available. Live schemas remain disabled until PROVIDER_HUB_API_KEY is configured server-side.
Add multiple comments to tasks or projects, optionally notifying collaborators. Each comment must specify either taskId or projectId.
Untrusted display-only summary
Add-filters
TODOIST_MCP_ADD_FILTERS
Add one or more new personal filters. Filters are saved custom views using query syntax to organize tasks.
Untrusted display-only summary
Add-labels
TODOIST_MCP_ADD_LABELS
Add one or more new personal labels.
Untrusted display-only summary
Add-projects
TODOIST_MCP_ADD_PROJECTS
Add one or more new projects.
Untrusted display-only summary
Add-reminders
TODOIST_MCP_ADD_REMINDERS
Add reminders to tasks. Supports three types: "relative" (minutes before due), "absolute" (specific date/time), or "location" (geofence-triggered). Each reminder must specify a taskId.
Untrusted display-only summary
Add-sections
TODOIST_MCP_ADD_SECTIONS
Add one or more new sections to projects.
Untrusted display-only summary
Add-tasks
TODOIST_MCP_ADD_TASKS
Add one or more tasks to a project, section, or parent. Supports assignment to project collaborators.
Untrusted display-only summary
Analyze-project-health
TODOIST_MCP_ANALYZE_PROJECT_HEALTH
Trigger 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.
Untrusted display-only summary
Complete-tasks
TODOIST_MCP_COMPLETE_TASKS
Complete one or more tasks by their IDs.
Untrusted display-only summary
Delete-object
TODOIST_MCP_DELETE_OBJECT
Delete 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 re…
Untrusted display-only summary
Export-project-template
TODOIST_MCP_EXPORT_PROJECT_TEMPLATE
Export 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 mo…
Untrusted display-only summary
Fetch
TODOIST_MCP_FETCH
Fetch the full contents of a task or project by its ID. The ID should be in the format "task:{id}" or "project:{id}".
Untrusted display-only summary
Fetch-object
TODOIST_MCP_FETCH_OBJECT
Fetch 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.
Untrusted display-only summary
Find-activity
TODOIST_MCP_FIND_ACTIVITY
Retrieve 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…
Untrusted display-only summary
Find-comments
TODOIST_MCP_FIND_COMMENTS
Find comments by task, project, or get a specific comment by ID. Exactly one of taskId, projectId, or commentId must be provided.
Untrusted display-only summary
Find-completed-tasks
TODOIST_MCP_FIND_COMPLETED_TASKS
Get 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 defau…
Untrusted display-only summary
Find-filters
TODOIST_MCP_FIND_FILTERS
List 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").
Untrusted display-only summary
Find-labels
TODOIST_MCP_FIND_LABELS
List 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…
Untrusted display-only summary
Find-project-collaborators
TODOIST_MCP_FIND_PROJECT_COLLABORATORS
Find 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 au…
Untrusted display-only summary
Find-projects
TODOIST_MCP_FIND_PROJECTS
List 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 paginat…
Untrusted display-only summary
Find-reminders
TODOIST_MCP_FIND_REMINDERS
Find reminders by task ID (returns all reminder types), or get a specific reminder by its ID. Use reminderId for time-based reminders and locationReminderId for location reminders.
Untrusted display-only summary
Find-sections
TODOIST_MCP_FIND_SECTIONS
Search for sections by name or other criteria in a project. When searching, uses server-side search to avoid fetching all sections.
Untrusted display-only summary
Find-tasks
TODOIST_MCP_FIND_TASKS
Find 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.
Untrusted display-only summary
Find-tasks-by-date
TODOIST_MCP_FIND_TASKS_BY_DATE
Get tasks by date range. startDate='today' includes overdue items. Default responsibleUserFiltering='unassignedOrMe' excludes others' tasks.
Untrusted display-only summary
Get-overview
TODOIST_MCP_GET_OVERVIEW
Get 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.
Untrusted display-only summary
Get-productivity-stats
TODOIST_MCP_GET_PRODUCTIVITY_STATS
Get 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…
Untrusted display-only summary
Get-project-activity-stats
TODOIST_MCP_GET_PROJECT_ACTIVITY_STATS
Get daily and optional weekly task completion counts for a project over a configurable time window (1-12 weeks). Useful for identifying completion trends and patterns.
Untrusted display-only summary
Get-project-health
TODOIST_MCP_GET_PROJECT_HEALTH
Get 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.
Untrusted display-only summary
Get-workspace-insights
TODOIST_MCP_GET_WORKSPACE_INSIGHTS
Get 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.
Untrusted display-only summary
Import-project-template
TODOIST_MCP_IMPORT_PROJECT_TEMPLATE
Import 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 imm…
Untrusted display-only summary
Provenance
Versioned facts, explicit trust.
The detail snapshot comes from an attributed MIT-licensed repository revision. Safe local icons use exact-match CC0 Simple Icons symbols; unmatched brands use monograms.