Taskwarrior turned my Linux terminal into a retro to-do list that syncs with Google Calendar and Keep

Published Oct 11, 2026, 3:00 PM EDT Zunaid Ali first became interested in technology after using a computer for the first time in 2006. He's been producing how-to content since 2018, reaching thousands of people in the process. As a kid, Zunaid used to read tech tutorials and troubleshooting guides on popular blogs. That made him want to start his own writing career. After the coronavirus pandemic, he finally decided to jump into the tech writing world. Before joining How-To Geek, he had written for HecticGeek, Distroid, and UbuntuPIT, among others. Zunaid first tried Linux when he wanted to learn Web Development in 2021. Due to his inexperience, he messed up his laptop trying to dual-boot Ubuntu with Windows. Frustrated, he went all-in with Linux and removed Windows completely. And that's when he fell in love with it. He's been actively experimenting with Linux since then. After finding his first writing gig on Linux in April 2022, he decided to specialize in it so he could share his knowledge and insights with fellow open-source enthusiasts. He joined How-To Geek in September 2023 and has been writing as a freelance contributor since then. Zunaid is currently pursuing his Bachelor's degree in Information & Communication Technology. When he's not writing, he's reading tech blogs, coding fun projects, or learning about new technologies. Other than Linux, he also has an interest in Android Development and Cybersecurity. He has experience in C/C++, Java, HTML/CSS/JavaScript, and Python. You can find some of his hobby projects on his GitHub. I'd never imagined that I would be using a task manager from the Linux terminal. Using commands to create to-do lists instead of using a cool-looking GUI with color customization options. That's until I came across Taskwarrior. It's a free, open-source task manager that's also simple to use. But that's the point. It can replace other bloated desktop apps. Now, I found a way to extend its capability even further. With a developer named bergercookie's syncall project, you can sync Taskwarrior bidirectionally with Google Calendar, Keep, and other popular services. I have a habit of storing my tasks in several places I needed a central system to manage all my tasks Over the years, I've used many apps and services for managing tasks. Google Keep, Sheets, Asana, ClickUp, and many other complicated task management apps. The thing is, each did something good enough to keep using it. For example, Google Keep is great at quick to-do creation. ClickUp is great for managing large tasks with multiple subtasks and deadlines. The problem was that I had no way to organize all these tasks across separate apps. I could perhaps use another app to maintain all my to-dos scattered throughout my workflow. But that just added yet another thing to look after. I needed a system that would sync my task lists across all the task managers I was using. Since Taskwarrior was something I was fond of, I only needed to connect it to the other services. Luckily, I found out about Syncall. It's a gateway to connect your Taskwarrior tasks to Google apps and other task software. At first glance, the documentation felt like gibberish. After working through it step by step, I finally synced my tasks with Google Keep and events on Calendar. Syncing Google Calendar and Keep with Taskwarrior Bridging the gap from the comfort of the terminal The first thing I tried was syncing Taskwarrior with my Google Calendar. I had to create a Google Cloud project, enable the Google Calendar API, set up an OAuth client, and more. The problem is, if you read the syncall documentation alone, you'll get stuck on a lot of steps. Here are the full steps I went through: Install syncall with pipx, using the google and tw extras: pipx install "syncall[google,tw]". If syncall complains about missing packages, run pipx inject syncall "setuptools. Newer setuptools removed a module it needs. Create a project in the Google Cloud console and enable the Calendar API. Set up the OAuth consent screen. Under Google Auth platform -> Audience, add your own Google account as a test user. Create an OAuth client ID of type Desktop app, then download its JSON file. Run the sync command with --google-secret pointing to that file. It prints a sign-in link. Open it, approve the access, and the first sync starts. I added a task with a remindme tag and a 3 PM due time. Then I ran tw_gcal_sync -c "TW Reminders" -t remindme --google-secret ~/client_secret.json in the terminal. The client_secret.json file is the JSON file I downloaded from my Google Cloud project. Then I went to my calendar, and the event was indeed created. My task also showed up there. Now, one catch is that it's not an automatic sync. Your Taskwarrior tasks won't appear on your calendar unless you run the sync command every time. To make things a bit easier, you can use aliases in the Linux terminal. Google Keep is possible too, but only in one direction Syncall's Keep sync works on one checklist note with Show checkboxes turned on. It syncs each item's text, checked state, and deletion. While going through the process, I found some roadblocks that a lot of you might not like. Not only is the process cumbersome, but it also relies on a third-party, unofficial library called gkeepapi. As a result, you have to enter your Google username and password for authentication. I followed the gpsoauth docs. Here's the process: 1. Install syncall with the gkeep and tw extras. The second line fixes the missing-module error from the setuptools change. pipx install "syncall[gkeep,tw]"pipx inject syncall "setuptools 2. Open the Google EmbeddedSetup page, sign in, and click I agree. The page may load slowly, so just ignore it. https://accounts.google.com/EmbeddedSetup 3. Copy the value of the oauth_token cookie from your browser. In Chrome, press F12 and open Application -> Cookies. In Firefox, open Storage > Cookies. Pick the accounts.google.com entry. The value starts with oauth2_4/. 4. Exchange that cookie for a master token with gpsoauth. My first try returned BadAuthentication, but a fresh cookie worked. Then set GKEEP_USERNAME, GKEEP_TOKEN, and GKEEP_PASSWD as environment variables in the terminal you'll sync from. The password just needs some value. 5. Start Python from the syncall environment. ~/.local/share/pipx/venvs/syncall/bin/python 6. Then paste the lines below. The last argument can be any 16-character hex string. A successful result prints a token that starts with aas_et/. import gpsoauthr = gpsoauth.exchange_token("you@gmail.com", "PASTE_OAUTH_TOKEN_HERE", "0123456789abcdef")print(r.get("Token"), r.get("Error")) Exit Python with exit(). Then export the variables in the same terminal you'll sync from: export GKEEP_USERNAME="you@gmail.com"export GKEEP_TOKEN="PASTE_MASTER_TOKEN_HERE"export GKEEP_PASSWD="placeholder" 7. Run tw_gkeep_sync -t keeptest -k "TW Keep Test". According to syncall's code, it reads your credentials from environment variables or the pass password manager. To try it, add a task with the tag, then sync: task add "Item from terminal" +keeptesttw_gkeep_sync -t keeptest -k "TW Keep Test" I know it's quite some setup. But it finally worked for me. A task I added in the terminal showed up in my Keep note. Then I marked it done and synced again, and Keep showed it as completed. However, an item I created in Keep never reached Taskwarrior. The sync hit a date error from Taskwarrior 3.5.0, and a missing pass folder caused a second error at the end. That one came after the sync had already finished. So, Keep worked in one direction for me. gkeepapi says a master token has full access to your Google account, so protect it like a password. My scattered to-dos finally have a home in the terminal That took a lot of time, research, and back-and-forth between my browser and the terminal to finally get it working. But it finally paid off. I can now manage my tasks and events from the minimalistic terminal, and one sync command handles everything else. Sure, two-way syncing didn't work for me. However, Taskwarrior has now joined my own list of CLI tools I install on every Linux system.