How to migrate Microsoft To Do to Things 3

Things 3

Quick answer

Open To Do Mover on a Mac, iPhone, or iPad with Things 3 installed, pre-create any tags you want to keep in Things, export with “Things 3” selected, and click each generated “Open in Things” button a few seconds apart to import your lists as projects.

Step-by-step

  1. Open To Do Mover on an Apple device with Things 3

    Use a Mac, iPhone, or iPad where Things 3 is installed. Sign in with Microsoft in To Do Mover, or load a todo-backup.json file you saved earlier on another computer.

  2. Pre-create any tags you want to keep in Things 3

    Things 3 silently drops tags that do not already exist in the app, so create matching tag names inside Things before starting the import.

  3. Check your time zone and export the Things 3 format

    Confirm your export time zone matches where you used Microsoft To Do, select “Things 3” (alongside “JSON backup”), and click Export.

  4. Click the “Open in Things” buttons one by one

    To Do Mover batches large lists into multiple buttons automatically. Click one button at a time, allow your browser to open Things, and pause a few seconds between clicks.

  5. Verify projects and tasks inside Things 3

    Confirm your projects, deadlines, checklists, and notes arrived as expected, then revoke To Do Mover's access in your Microsoft account settings.

How the Things 3 URL Scheme import works

With Microsoft To Do apps retiring on June 30, 2027, moving to Things 3 requires a slightly different workflow because Things does not offer a generic file importer. Instead, Cultured Code provides the official Things URL Scheme (things:///json), which accepts structured JSON payloads to create projects and to-dos without needing an authorization token.

The To Do Mover export tool builds those things:///json links locally in your browser. Clicking a button hands the data straight to Things 3 on your device—no external server is involved.

If you are working on a Windows PC, follow the Microsoft To Do backup guide to export todo-backup.json, move that file to your Mac, iPhone, or iPad, and reopen it offline in To Do Mover to generate clickable Things buttons.

What transfers and what goes into notes

Data item Migration result Details
Lists Projects Each list creates a Things project; batched links append to the same project
Task title Preserved Imported as a to-do inside the matching project
Due date Deadline Restored in your export time zone (YYYY-MM-DD) and mapped to Things’ deadline field
Steps (sub-tasks) Checklist items Keeps checked state; capped at Things’ 100 checklist-item limit per to-do
Notes Plain text Rich formatting becomes plain text; capped at Things’ 10,000-character limit per to-do
Completed status & timestamps Preserved Sets completed, creation-date, and completion-date
Categories Tags (if pre-existing) Only tags that already exist in Things are applied; unknown tags are dropped
Repeat rules Appended to notes Things’ JSON command cannot create repeating tasks; readable repeat text is added to notes
Reminders Appended to notes Not created as active reminders; saved as text at the end of notes
Start dates Appended to notes Saved as text at the end of notes rather than mapped to Things’ when date
Linked resources Appended to notes Includes URLs such as Outlook flagged emails (flagged-email fields not yet verified on a live account)
Importance Not mapped Things 3 has no built-in priority field
Attachments Not included URL Scheme links cannot carry files; download them alongside your JSON backup
My Day and list groups Not available Not exposed by Microsoft Graph; all lists export flat

Preparing Things 3 before clicking the buttons

  1. Create your tags first: Open Things 3 and add any Microsoft To Do category names you want to keep (matching exact spelling and capitalization).
  2. Test with a single list first: Live Things 3 import behavior has not yet been tested end-to-end across every edge case. Select one small list (or use demo mode first), click its link, and confirm how the project, checklist items, deadlines, and tags appear before migrating all lists.
  3. Pause between clicks: Cultured Code documents a rate limit of 250 items per 10 seconds for the Things URL Scheme. Even though To Do Mover caps each button at 50 to-dos, click one “Open in Things” button at a time and wait a few seconds before clicking the next.
  4. Watch for very long notes: URL encoding expands non-ASCII text significantly. If a single task’s notes push a link beyond 32,000 characters, To Do Mover still generates the button and warns you under “Notes from the export”. If that link fails to open, shorten the note and re-export, or copy the text from things-import.json.

Post-import checks and troubleshooting

  • Clicking a button does nothing: Make sure Things 3 is installed on the same device and allow the browser prompt to open external things:// links. If a strict browser blocks custom protocols, try Safari or Chrome.
  • Duplicate projects appeared: Clicking the first batch button of a list twice creates two projects with the same name. Delete the duplicate project in Things and avoid double-clicking buttons while Things is still processing.
  • Truncated notes or missing steps: Check “Notes from the export” on the completion screen for warnings about Things’ 10,000-character notes limit or 100-step checklist limit. The complete text remains intact in your todo-backup.json.
  • Recreating recurring tasks: Review tasks with repeat rules noted at the bottom of their notes and set up repeating to-dos manually inside Things 3.

Exploring other destinations? See our guides for Todoist, Obsidian, or read the FAQ.

Common questions

Why is the Things 3 format grayed out on Windows or Android?

Things 3 is available only on macOS, iOS, and iPadOS, and To Do Mover imports into Things through the local things:///json URL Scheme, which only works on devices where Things 3 is installed.

If you normally use Microsoft To Do on Windows, export todo-backup.json on Windows first, transfer it to your Mac, iPhone, or iPad, load it offline in To Do Mover, and click the generated Things links there.

Why were my Microsoft To Do categories not applied as tags in Things 3?

Per Cultured Code's Things URL Scheme specification, tags passed through a JSON link must already exist in Things; any unknown tag is silently ignored.

Create the exact category names as tags inside Things 3 before clicking the “Open in Things” buttons if you want to keep them.

Why is one list split into multiple buttons, and what is things-import.json?

Each link is capped at 50 to-dos and 32,000 URL characters so the operating system does not truncate or reject overly long custom-scheme links. The first button creates the project, and subsequent buttons append to-dos to that same project rather than creating duplicates.

The accompanying things-import.json file contains the full JSON payload in case advanced users want to process it with custom scripts or Apple Shortcuts.

Sources

Ready to export your tasks?

Everything runs locally in your browser. Start with a lossless JSON backup or try the demo first.