https://github.com/sh78/google-tasks-taskwarrior-import
Get all of you Google Tasks into Taskwarrior, where they belong.
https://github.com/sh78/google-tasks-taskwarrior-import
bunny-rabbits getting-things-done google google-takeout google-tasks gtd json productivity rainbows tasks taskwarrior2 unicorns
Last synced: 3 months ago
JSON representation
Get all of you Google Tasks into Taskwarrior, where they belong.
- Host: GitHub
- URL: https://github.com/sh78/google-tasks-taskwarrior-import
- Owner: sh78
- Created: 2018-07-11T06:13:14.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2018-07-20T03:54:00.000Z (over 7 years ago)
- Last Synced: 2025-10-06T02:42:28.348Z (3 months ago)
- Topics: bunny-rabbits, getting-things-done, google, google-takeout, google-tasks, gtd, json, productivity, rainbows, tasks, taskwarrior2, unicorns
- Language: JavaScript
- Homepage:
- Size: 9.77 KB
- Stars: 10
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Import From Google Tasks To Taskwarrior
🚨 Danger Zone: This software is battle tested. We here at Import Google
Tasks To Taskwarrior do hope it saves you some time and frustration, but please
don't blindly run it against your production database (of tasks). It has been
used successfully on macOS 10.13.5 (17F77) with `node` v10.4.0 and `task` 2.5.1.
## What It Does
Reads a JSON export from [Google Takeout] of [Google Tasks] and runs
[Taskwarrior] shell commands (`task`) on your system to import the tasks.
- Each "list" from Google Tasks is added verbatim as the `project:` for the task
in the Taskwarrior command.
**Protip:** If your task lists in Google Tasks contain Emojis and such, best
sanitize those out of your JSON payload first.
- If a task contains notes (the text box below with extra details), they are
added as a single [annotation][Taskwarrior Annotations]
- Subtasks for a Google Task are added as [dependencies][Taskwarrior
Dependencies] of their parent task using `depends:`.
- All imported tasks are assigned a Taskwarrior tag "googleTasks"
(`+googleTasks`) to keep track of what was imported.
**Protip:** If you want to further [modify tasks][Taskwarrior Modify] after
importing, run `task +googleTasks modify [[YOUR MODS]]` to do them all at
once.
- Completed tasks from the Google export are still added, using the `task log`
command to mark them as done on arrival.
## What It Might Do Later
- [ ] Use [chalk] for nice output
- [ ] Annotate every task with the original JSON
- [ ] Support due dates
- [ ] Handle adding indented tasks from Google as blocking tasks in Taskwarrior
- [ ] Deal with tasks that are linked to Gmail messages
- [ ] Have an option to pull directly from the Google Tasks API
## Usage
npm install -g google-tasks-taskwarrior-import
google-tasks-taskwarrior-import ~/path/to/Tasks.json
# profit
## Troubleshooting
There isn't much error handling, due to budget concerns for the current fiscal.
If an import exits with errors, you can likely run `task +googleTasks delete` to
destroy all imported tasks and try again after debugging.
[Google Takeout]: https://takeout.google.com/
[Google Tasks]: https://gsuite.google.com/learning-center/products/apps/keep-track-of-tasks/
[Taskwarrior]: https://taskwarrior.org/
[Taskwarrior Annotations]: https://taskwarrior.org/docs/terminology.html#annotation
[Taskwarrior Dependencies]: https://randomgeekery.org/2018/02/19/setting-task-dependencies-in-taskwarrior/
[Taskwarrior Modify]: https://taskwarrior.org/docs/commands/modify.html
[chalk]: https://github.com/chalk/chalk