---
title: 'From Toggl Track'
url: 'https://chronoslice.app/docs/moving-to-chronoslice/from-toggl-track'
markdown: 'https://chronoslice.app/docs/moving-to-chronoslice/from-toggl-track.md'
date: '2026-11-14'
description: "The Toggl Track importer brings your history into ChronoSlice from the server's command line, then checks it against Toggl's own totals. You can run it while you still use Toggl, and again on the day you switch. This page shows the steps. What comes across Your workspace, as an organization: its n…"
taxonomy:
  kb_category:
    - 'Moving to ChronoSlice'
---

[Docs](https://chronoslice.app/docs)

 [Contact support](https://chronoslice.app/help/new) 

Docs menu

# From Toggl Track

Import your clients, projects, tags, rates and every time entry from Toggl Track, check the totals, and switch over.

 Updated Nov 14, 2026 4 min read

The Toggl Track importer brings your history into ChronoSlice from the server's command line, then checks it against Toggl's own totals. You can run it while you still use Toggl, and again on the day you switch. This page shows the steps.

## What comes across

- Your workspace, as an organization: its name, currency and default rate.
- Clients, projects, tasks and tags. A client takes the currency its projects bill in, so a client whose Toggl projects are in euros bills in euros here.
- Members and groups, with their rates, including the rates people have on a project.
- Every time entry, with its project, task, tags, billable setting, and the rate and currency Toggl billed it at.
- Your own Toggl account, as your ChronoSlice account and the organization's owner. It has no password yet.

The other people in your workspace come in as teammates without an account. They appear on the **Team** page as `No account — imported`, and their time stays in reports. See [People and roles](https://chronoslice.app/docs/using-chronoslice/people-and-roles).

## Before you start

- Install ChronoSlice and make sure the service is running. See [Install on Linux](https://chronoslice.app/docs/installing/install-on-linux).
- You can skip [setup](https://chronoslice.app/docs/installing/the-first-account). The importer creates your account and organization from your workspace. If you did set up first, use the same email as your Toggl account. The workspace then comes in as a second organization that you own, next to the one setup made, and you switch between them from the account menu.
- Find your Toggl API token: in Toggl, open **Profile settings**, then **API Token**.
- Imports are refused when the server is read-only after the trial. They also respect your edition's user limit, and your account counts as one active user.

## Run the import

Read the token without leaving it in your shell history, then run the importer as the `chronoslice` user:

```sh
read -rs TOGGL_API_TOKEN && export TOGGL_API_TOKEN
sudo -u chronoslice env CHRONOSLICE_DB=sqlite:///var/lib/chronoslice/chronoslice.db \
  TOGGL_API_TOKEN="$TOGGL_API_TOKEN" chronoslice import toggl
```

It fetches the whole workspace, then writes it in one go. Ten years of a small agency's history takes about 40 requests to Toggl, which is well inside what Toggl's Starter plan allows in an hour. When it finishes it prints a summary as JSON: how many of each kind were new, changed or the same, and how many entries were deleted or had no project.

In Toggl each project has its own currency, while in ChronoSlice the client sets it (see [Rates and currencies](https://chronoslice.app/docs/using-chronoslice/clients-projects-tasks-and-tags)). When that doesn't line up, the summary's `currency_notes` says so: a client whose projects bill in different currencies gets the one most of its time is in, and a project with no client that bills in another currency than your workspace's stays in the workspace's currency for new time. Time already tracked keeps the currency Toggl billed it in either way.

Two options narrow it down:

- `--workspace <id>` picks a workspace. The default is your token's default workspace.
- `--from-year <year>` is the first year of entries to fetch. The default is the start of your account.

## Check it

Compare ChronoSlice's totals with Toggl's own reports:

```sh
sudo -u chronoslice env CHRONOSLICE_DB=sqlite:///var/lib/chronoslice/chronoslice.db \
  TOGGL_API_TOKEN="$TOGGL_API_TOKEN" chronoslice reconcile toggl
```

`reconcile` compares hours per project and person over all years against Toggl's summary report, and amounts against what Toggl calculated for each entry. It prints what matched and what didn't, and exits with status 1 when something is off. If amounts differ by a few cents, check whether your Toggl workspace rounds amounts down per entry. ChronoSlice has the same option, **Round amounts down**, in **Settings**, under **Organization**.

## Give yourself a password

The imported account has no password, so you can't sign in yet:

```sh
sudo -u chronoslice env CHRONOSLICE_DB=sqlite:///var/lib/chronoslice/chronoslice.db \
  chronoslice user set-password you@example.com
```

It asks for the password. Then sign in to the web app with that email.

## Run it again

The import is a full sync, so you can run it as often as you like. Only what changed in Toggl is updated, and entries you deleted in Toggl are removed here too. Run it while you still use Toggl, look over the numbers, and run it once more on the day you switch.

Stop any running Toggl timer before the last import.

## If you already imported somewhere else

If you imported on another machine, copy that database to the server instead of importing again. See [Backups and restoring](https://chronoslice.app/docs/installing/backups-and-restoring).

## After the switch

- Add your clients' billing emails and addresses under **Clients**.
- Set your invoice numbering under **Invoices**, then **Settings**.
- If you kept prepaid support hours in Toggl as tasks, see [Support hour blocks](https://chronoslice.app/docs/using-chronoslice/support-hour-blocks).
- Install the [Mac app](https://chronoslice.app/docs/mac-app/installing-and-signing-in).

## Related

- [People and roles](https://chronoslice.app/docs/using-chronoslice/people-and-roles)
- [What ChronoSlice is](https://chronoslice.app/docs/getting-started/what-is-chronoslice)
- [The first account](https://chronoslice.app/docs/installing/the-first-account)
- [Support hour blocks](https://chronoslice.app/docs/using-chronoslice/support-hour-blocks)

## Still stuck?

Send us a request: it goes to the people who build ChronoSlice, and the reply comes by email. Include your ChronoSlice version (Settings › Licence shows it) and what you tried.

 [Contact support](https://chronoslice.app/help/new?from=%2Fdocs%2Fmoving-to-chronoslice%2Ffrom-toggl-track)[Your requests](https://chronoslice.app/help/tickets)

---

## Navigation

- Parent: [Moving to ChronoSlice](https://chronoslice.app/docs/moving-to-chronoslice.md)
- Next: [From Square](https://chronoslice.app/docs/moving-to-chronoslice/from-square.md)
