/toggl-to-jira

Import your time entries from Toggl.track into Jira

Primary LanguageGoBSD 3-Clause "New" or "Revised" LicenseBSD-3-Clause

Toggl.track to Jira

It is a small application which can be executed manually or via crontab. This application will export your toggl.track report for selected period to the work-logs of your Jira project. I wrote this app because, I hate the Jira work-log UI. From my point of view it is useless and not really usefull. You could easily add a toggl.track browser extension and that will be better than this stupid "work-log" input form.

Requirements

As each application, my app also requires some things to be done, before the execution.

  1. You must have an account in Jira, so you can create the Jira auth token. Click here to see how.
  2. Create the toggl.track API token. Click here to see how.

Installation

  1. Download the binary for your system from bin/ to the ~/toggl-to-jira folder in your system. Of course, it is up to you, what kind of folder select.
  2. Make sure all needed environment variables has been set in the .env.
  3. Using Command line tool, please go to ~/toggl-to-jira(or your path) and run the following command: 
     ./{your-binary}
    Please note, that after start the app will try to fetch the time entries from toggl API and send it to the Jira API. In my case there was no time entries to put in Jira, so here what I saw: app-dry-run Done.

How it works

The main approach is:

  1. We fetch the data from the toggl.track API using /reports/api/v2/details?workspace_id={workspace_id}&user_agent={user_agent}&since={date_from}&until={date_to}
  2. For each time entry we try to get the number of minutes and send the work log

Please, also have a look at the flowchart diagram: flowchart

Available arguments

  1. date_from - The starting date for the filter export. Please use next format: YYYY-MM-DD (default "2021-03-27")
  2. date_to - The ending date for the filter export. Please use next format: YYYY-MM-DD (default "2021-03-27")
  3. workspace_id - The workspace ID which should be used for the toggl.track data report generation. By default, will be used the ID from TOGGL_DEFAULT_WORKSPACE_ID environment variable.

Please use --help for more details.

When app ignore time entries from toggl.track?

There are conditions, when we ignore the received time entry:

  1. We already processed the time entry
  2. In description of the time entry we could not find the Jira Task key
  3. The number of minutes spent is less the 1

Troubleshooting

Cannot run the app in MacOS Big Sur

  1. Make sure you allow to application execution in Security & Privacy settings
  2. Make sure you move your application to the folder outside of base system folders. Eg: ~/Downloads it is a system folder. Create a new folder in ~/ path and run the application from there.

I receive error "It looks like there are problems with config. Stop running the script" Please, make sure you defined all required environment variables. You can find the list of them in .env.example.

My Setup

I would recommend use this application with combination of toggl.track browser extension, which you can find here. And also I would recommend to set the crontab event for your application execution, so you will not care about the work-log sync anymore.

The same thing I did on my PC. I installed the app into crontab to send the Jira report every 2 hours, so I don't bombard Jira and Toggl.track APIs. Plus, in my browser I installed the Toggl.track browser extension and enabled in the extension settings Jira support like in the image below: enable-jira At the end, for all tasks in Jira I have a button to start/stop the timer and all my working hours are in sync. It is free and very useful.