How to Migrate from Microsoft To Do to Vikunja with Direct or CSV Import
Vikunja offers a Microsoft To Do importer and a CSV import on supported versions. Its software is free to self-host; managed Vikunja Cloud is not a free-forever hosting promise.
Before you start: keep a safe copy.
Read the master export guide1Back up before moving anything
Start with the master export guide and keep the backup somewhere you control. Record each source list name and active-task count. Save attached files separately and note important reminders, recurring rules and shared-list members. Choose one small test list first. Keep Microsoft To Do intact until you have confirmed the destination on every device.
2Choose hosting and make a destination backup
Create a managed account at vikunja.cloud or use a maintained self-hosted instance. If self-hosting, review updates, backups and secure access before storing personal tasks. Export any existing Vikunja data from Settings → Data Export before importing into a workspace that already contains tasks.
3Use the Microsoft To Do importer when enabled
Open Settings → Import or Import from other services and choose Microsoft To Do. Sign in to the correct Microsoft account and review permissions. If the importer is not listed on a self-hosted instance, the administrator must enable and configure it, including the correct public URL and OAuth settings. Do not paste your Microsoft password into an unrelated import form.
4Use CSV mapping as a fallback
On a version supporting CSV import, choose CSV and upload a small test file. Map task title, description, due date, priority and project where offered. Inspect detected delimiters and dates rather than accepting them blindly. Older instances may not support this importer; update safely or create tasks manually from your readable backup instead.
5Verify task coverage and invite collaborators
Compare list names and counts with the source. Check subtasks, notes, completed tasks and recurring schedules individually, because importer coverage can differ. Save attachments separately until you know they transferred. Invite collaborators to the new projects explicitly and verify permissions. Keep your source tasks until you have tested the new instance on all devices.
6Audit your new lists before switching
Compare active task counts list by list, then inspect an item with a date, a note, a subtask and a recurring schedule. Search for two distinctive task titles to catch omissions or duplicates. Open the destination on your daily devices and confirm changes sync. Test notifications with a task due in a few minutes. Keep the backup and old lists until you are confident; only then make the new app your daily home.
How to replace “My Day” in Vikunja
Open Overview to review upcoming work. Use due-date filters or a dedicated Today label or project for a manually selected focus list. Keep undated backlog tasks outside that daily selection, and clear or replan it each morning. A date-based overview is not an automatically resetting My Day list.
Keep these checks in mind
- A copied list is not a shared list until you invite people again.
- CSV and text migration can omit reminders, attachments and recurrence.
- Check current plan limits before uploading private data or paying.
Documentation & further reading
Ready for your first list in Vikunja?
Start with one small list. Verify it on your everyday devices before moving everything.
Try Vikunja FreeSome links may earn a commission at no extra cost to you. Affiliate disclosure