Skip to content
Migration Guides

Switch to Miru
with your time history.

Export your time entries, match your team and preview the import. Check the imported totals before cancelling your old tool. Keep separate copies of expense, invoice and payment records; the CLI imports time entries only.

No migration consultants. No six-week onboarding project.

Migration steps: export CSV, add the team, preview, import and verify.

Migration questions we hear every week

Will we lose historical time entries when migrating?
No. Miru imports historical entries, projects, and clients from CSV. Most teams validate the import with one sample client before full cutover.
Do we need a consultant to migrate?
No. The migration guides are built for operators and engineers. If you can export CSV, you can migrate.
Can we migrate first and invite the team later?
The importer matches people to existing Miru workspace members. Add your team first, then preview the import. If names differ, use --map to match a CSV name to an existing member's email. Mapping does not create a member.

Every migration works the same way

Five steps. No consultants. No "migration specialists." No three-week onboarding program.

1

Export your data

CSV from your old tool

2

Create your workspace

Add the people in your CSV

3

Import via CLI

Dry run first, then for real

4

Verify the import

Compare hours and resolve errors

5

Switch when ready

Keep the records you still need

Using something else?

If your current tool exports time entries as CSV, Miru can import them. Rename the headers to the six columns the guides use (date, client, project, hours, first name, last name), add a notes column if you want descriptions, and run a dry run first. Sign in with the CLI as a workspace owner or admin and match people to existing workspace members, as shown in the Harvest guide.

$ miru import --file time-entries.csv --format harvest --dry-run

A dry run does not create time entries. Resolve row errors and unmatched people, then run without --dry-run, keeping the same mapping arguments. Compare the imported totals with your export before cancelling the old tool.

$ miru import --file time-entries.csv --format harvest

Start with a preview.

Keep your history. Check the numbers. Switch when you're ready.

One plan. No tiers. See pricing