MCP SERVERClean up a Todoist account that got away from you: group duplicate tasks by similarity, merge them, bulk-edit everything matching a filter, then read the activity log to see what changed.
LABSCO SUMMARY
Most Todoist integrations stop at creating and completing tasks. This one adds the operations you avoid because they are tedious in the UI: finding near-duplicate tasks by similarity and merging them, updating every task matching a filter in one call, and reading the activity log by project or date range when you need to reconstruct what happened. Two things to know before you count on the whole surface: ten tools name a Todoist plan in their own description — filters and reminders want Pro or Business, shared labels and workspaces want Business, and three of the 86 exercise the server rather than your data.
A Todoist client with 86 tools covering tasks, projects, sections, labels, filters, reminders, comments, activity history, backups and workspace invitations.
A Todoist account and its API token in TODOIST_API_TOKEN. Filters and reminders need a Pro or Business plan; shared labels and workspaces need a Business account.
One command plus a key — npx @greirson/mcp-todoist, then supply credentials
USE CASES
Group near-identical tasks by similarity, merge each group down to one, then close out everything left matching a filter. The work is done against search criteria rather than task by task.
Write each action the way you would say it and let the parser pull out the project, label, assignee and priority. Where an action has parts, the subtasks go in under it in the same call.
Move tasks and whole sections between projects, re-parent a project under another, and set the new running order — the rearranging that is slow to do by dragging.
Pull the event history for a date range or a single project, add the completed tasks behind it, and you have a report built from the log rather than from memory.
Bulk delete is irreversible, so list the automatic backups first and take the download URL for the most recent one. The URL is time-limited, and the file is a ZIP of CSV exports.
Invite by email, read back the collaborator list to get the user IDs assignment needs, and leave the context they will want in a comment on the task itself.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
todoist_activity_by_date_rangeGet Todoist activity log within a specific date range. Returns all events that occurred between the specified dates. Useful for generating activity reports and reviewing changes over time periods.
todoist_activity_by_projectGet Todoist activity log for a specific project. Returns all events (tasks added/completed/deleted, comments, etc.) related to the project. Useful for project auditing and tracking project-specific changes.
todoist_activity_getGet Todoist activity log with optional filters. Returns events for items, notes, projects, sections, labels, filters, and reminders. Useful for auditing changes, tracking productivity, and understanding workspace history.
todoist_archived_projects_getGet a list of all archived projects. Useful for reviewing or restoring archived projects.
todoist_backup_downloadGet the download URL for a specific backup version. The URL is time-limited. Backups are ZIP files containing CSV exports of your Todoist data.
todoist_backups_getList all available automatic backups of your Todoist data. Todoist creates backups automatically. Returns version timestamps and download URLs.
todoist_collaborators_getGet a list of collaborators for a shared project. Returns user IDs, names, and emails that can be used for task assignment with assignee_id.
todoist_comment_createAdd a comment to a task or project in Todoist. For task comments, provide task_id or task_name. For project comments, provide project_id.
todoist_comment_deleteDelete a comment by its ID
todoist_comment_getGet comments for a task or project in Todoist
todoist_comment_updateUpdate an existing comment's content by comment ID
todoist_completed_tasks_getRetrieve completed tasks from Todoist. Uses the Sync API to fetch tasks that have been marked as complete. Supports filtering by project, date range, and pagination.
todoist_duplicates_findFind duplicate or similar tasks using content similarity analysis. Returns grouped tasks that have similar titles, sorted by similarity percentage.
todoist_duplicates_mergeMerge duplicate tasks by keeping one task and completing or deleting the others. Use after todoist_duplicates_find to clean up duplicates.
todoist_filter_createCreate a new custom filter in Todoist. Filters use Todoist's query syntax (e.g., 'p1', 'today', '@label', '#project'). Note: Requires Todoist Pro or Business plan.
todoist_filter_deleteDelete a filter from Todoist. This action cannot be undone. Note: Frozen filters (from cancelled subscriptions) cannot be deleted.
todoist_filter_getGet all custom filters in Todoist. Filters are saved searches that help you organize and view tasks based on specific criteria. Note: Requires Todoist Pro or Business plan.
todoist_filter_updateUpdate an existing filter in Todoist. Can update name, query, color, order, or favorite status. Note: Frozen filters (from cancelled subscriptions) cannot be modified.
todoist_invitation_acceptAccept a project sharing invitation. Requires both the invitation ID and secret from the invitation email.
todoist_invitation_deleteDelete/revoke a pending invitation that you sent. Use this to cancel an invitation before it is accepted.
todoist_invitation_rejectReject a project sharing invitation. Requires both the invitation ID and secret.
todoist_invitations_getGet all pending project sharing invitations received by the current user.
todoist_label_createCreate a new label in Todoist
todoist_label_deleteDelete a label from Todoist
todoist_label_getGet all labels in Todoist
todoist_label_statsGet usage statistics for all labels in Todoist
todoist_label_updateUpdate an existing label in Todoist
todoist_notification_mark_readMark a specific notification as read.
todoist_notifications_getGet live notifications including comments, assignments, sharing invitations, and other collaboration events.
todoist_notifications_mark_all_readMark all notifications as read.
todoist_productivity_stats_getGet detailed productivity statistics including karma, task completion history, daily/weekly streaks, and goals progress.
todoist_project_archiveArchive or unarchive a project in Todoist. Archived projects are hidden from the main view but can be restored.
todoist_project_collaborators_getGet a list of collaborators for a shared project in Todoist. Returns collaborator names and emails.
todoist_project_createCreate a new project in Todoist with optional sub-project hierarchy, description, and view style
todoist_project_deleteDelete a project from Todoist. This will also delete all tasks and sub-projects within the project.
todoist_project_getGet a list of all projects from Todoist with their IDs, names, descriptions, and hierarchy information
todoist_project_inviteInvite a user to collaborate on a project by email. The invitee will receive an email notification.
todoist_project_move_to_parentMove a project under another project (making it a sub-project) or to root level. Useful for organizing project hierarchies.
todoist_project_note_createCreate a new note for a project. Project notes are visible to all project collaborators.
todoist_project_note_deleteDelete a project note by ID.
todoist_project_note_updateUpdate an existing project note's content.
todoist_project_notes_getGet all notes for a specific project. Project notes are shared with all project collaborators.
todoist_project_updateUpdate an existing project in Todoist. Can modify name, color, favorite status, description, or view style.
todoist_projects_reorderReorder projects by specifying their new positions. Controls project ordering in the sidebar.
todoist_reminder_createCreate a new reminder for a task. Supports three reminder types: relative (minutes before due), absolute (specific date/time), and location-based. Requires Todoist Pro or Business plan.
todoist_reminder_deleteDelete a reminder. Requires Todoist Pro or Business plan.
todoist_reminder_getGet all reminders, optionally filtered by task. Reminders require Todoist Pro or Business plan.
todoist_reminder_updateUpdate an existing reminder. Can change the type, timing, or location settings. Requires Todoist Pro or Business plan.
todoist_section_archiveArchive a section. Archived sections are hidden but not deleted. Tasks in the section are also archived.
todoist_section_createCreate a new section within a project in Todoist
todoist_section_deleteDelete a section and all its tasks from Todoist. Can delete by section ID or section name search.
todoist_section_getGet a list of sections within a project from Todoist with their IDs and names
todoist_section_moveMove a section to a different project. All tasks in the section will move with it.
todoist_section_unarchiveUnarchive a previously archived section. Restores the section and its tasks to active status.
todoist_section_updateUpdate an existing section in Todoist. Can update name by section ID or section name search.
todoist_sections_reorderReorder sections within a project by specifying their new positions.
todoist_shared_label_removeRemove a shared label from all items in the workspace. This removes the label from all tasks but does not delete the tasks. Requires Todoist Business account.
todoist_shared_label_renameRename a shared label across all items in the workspace. Updates the label name for all team members. Requires Todoist Business account.
todoist_shared_labels_getGet all shared labels in the workspace. Shared labels are available in Todoist Business accounts for team collaboration.
todoist_subtask_createCreate a new subtask under a parent task in Todoist
todoist_subtask_promotePromote a subtask to a main task (remove parent relationship)
todoist_subtasks_bulk_createCreate multiple subtasks under a parent task in a single operation
todoist_task_closeClose a task. For recurring tasks, this completes the current occurrence and schedules the next one. For non-recurring tasks, this is equivalent to completing the task.
todoist_task_completeMark a task as complete found by ID or partial name search (case-insensitive)
todoist_task_convert_to_subtaskConvert an existing task to a subtask of another task
todoist_task_createCreate a new task in Todoist with optional description, due date, priority, labels, deadline, project, section, and duration for time blocking
todoist_task_day_order_updateUpdate the day order of tasks in the Today view. Controls the order tasks appear when viewing today's tasks.
todoist_task_deleteDelete a task found by ID or partial name search (case-insensitive)
todoist_task_getRetrieve tasks from Todoist. Use 'filter' for Todoist filter syntax (e.g., 'today', 'p1') or 'task_name' for simple text search in task content
todoist_task_hierarchy_getGet a task with all its subtasks in a hierarchical structure
todoist_task_moveMove a task to a different project, section, or under a parent task. Uses Todoist Sync API for reliable movement operations.
todoist_task_quick_addCreate a task using natural language parsing like the Todoist app. The text is parsed to extract due dates, projects (#), labels (@), assignees (+), priorities (p1-p4), deadlines ({in 3 days}), and descriptions (//). Example: "Buy groceries tomorrow #Shopping @errands p1 {deadline Friday} //Don't forget milk"
todoist_task_reopenReopen a previously completed task found by ID or partial name search (case-insensitive). Use this to restore a task that was marked as complete.
todoist_task_reorderSet the order of a task within its project/section. Lower numbers appear first.
todoist_task_updateUpdate an existing task found by ID or partial name search. Supports updating content, description, due date, priority, labels, deadline, project, section, and duration
todoist_tasks_bulk_completeComplete multiple tasks at once based on search criteria. Efficiently mark many tasks as done.
todoist_tasks_bulk_createCreate multiple tasks at once for improved efficiency. Each task can have full attributes including duration for time blocking.
todoist_tasks_bulk_deleteDelete multiple tasks at once based on search criteria. Use with caution - this will permanently delete matching tasks.
todoist_tasks_bulk_updateUpdate multiple tasks at once based on search criteria. Supports updating content, priority, due dates, labels, project, section, and duration.
todoist_tasks_reorder_bulkReorder multiple tasks at once by specifying their new positions. Efficient for reorganizing task lists.
todoist_test_all_featuresRun comprehensive tests on all Todoist MCP features to verify functionality
todoist_test_connectionTest the connection to Todoist API and verify API token validity
todoist_test_performanceMeasure performance and response times of Todoist API operations
todoist_user_getGet information about the current Todoist user including name, email, timezone, karma, and account settings.
todoist_user_settings_getGet user settings including reminder preferences, notification settings, sounds, and theme configuration.
todoist_workspaces_getGet all workspaces for the current user. Workspaces are available with Todoist Business accounts for team organization.
BEFORE YOU INSTALL
86 tools when we connected. The documentation describes 19 consolidated tools such as todoist_task and todoist_project; none of those names exist on the server, which uses granular names like todoist_task_create.
CONTEXT COST
Rated by the size of the 86 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npx @greirson/mcp-todoistDownload todoist-mcp.mcpb from the latest release and double-click it, then enter your Todoist API token when prompted
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": [
"@greirson/mcp-todoist"
],
"env": {
"TODOIST_API_TOKEN": "<YOUR_TODOIST_API_TOKEN>"
}
}
}
}MCP servers
koki-develop
abhiz123
DiversioTeam
George5562