A user-friendly command-line tool for synchronizing time entries from Toggl Track to Moneybird.
pip install toggl2moneybird
Using the tool is self-explanatory. On first-time use, a browser window will open asking you to authorize the tool to access your Moneybird administration. It will also ask you for your Toggl Track email address and password as needed, but you may alternatively enter the API token listed at the bottom of your profile page.
To start the synchronization, type the following command. The tool will always ask you to confirm any changes, so you do not need to worry about the tool automatically making changes to your administration.
toggl2moneybird sync
Only time entries corresponding to a project are synced. By default, only
billable items are synced, but you can add the --unbillable flag to include
unbillable items as well.
You can also automatically create a draft invoice for a particular contact and period using the following command:
toggl2moneybird invoice
The invoice will not be sent out automatically. Instead, a browser window will open with the draft invoice in Moneybird, allowing you to send it from there.
The Toggl Track API only allows accessing the last three months worth of data. It is highly advised to run the sync at least once every month!
Currently, there is no mapping done between users - all time entries will be logged under the same user (you will be asked which one if there are multiple).
It's not likely that you'll hit the rate limit of the Moneybird API using this tool, but if you do, the tool does not handle it gracefully and will quit with an exception. Simply try again at a later time if you encounter this issue.
If you encounter any problems, please do not hesitate to report them in the issue tracker. Feature requests are also welcome!