Tasky: A CLI Google Tasks Client in Python

31 May

I’ve been looking for a nice and fast Google Tasks client for a long time. There do exist a lot of them but none that I have encountered matched what I was looking for in terms of functionality and ease of use. Given that I have a bit of free time this summer, I decided to write one myself.

This task would have been really hard and clunky a month ago. Luckily, Google introduced the Tasks API about three weeks ago, a hugely requested feature. I hadn’t worked with Google APIs before so I took it up as a challenge to figure out how it all works and put together my client in a few days’ time. I also decided to go with Python this time, as I’d like to get more practice with the language (which I this is really amazing, by the way). The result of the past three days is a very simple and fast client for Google Tasks that works in the command line.


First, I had to define what I wanted to accomplish with this project. I wanted a way to retrieve tasks from one or more task lists (I currently have one but have used multiple in the past), have a way to quickly add, remove, and check/uncheck tasks. I wanted the whole thing to work in the terminal, as that’s where I spend most of my time working. And I wanted the commands to be as short as possible, as to minimize the amount of typing necessary. Specifically, I did not want to have to type an entire task’s name in order to perform some action on it. And I wanted the whole thing to take as little time as possible between subsequent operations – I didn’t mind a possibly shutdown if I could have fast removes and adds and toggles while the application was open. Finally, I wanted to have two modes: Normal Mode and Quick Mode. In Normal Mode, the application is opened and kept running, allowing me to make a series of changes to it before closing. In Quick Mode, I perform a single operation fully specified as arguments in the command line. The changes are made (with ambiguities resolved when necessary) and the application closed immediately. And I wanted to have it do authentication in order to access account information from any computer I choose to run the application on.


I was able to accomplish all of these goals by loading all task lists into memory upon startup and committing all changes to the server when closing the application. The Tasks API is still in Labs, which means it could change from the time of this writing, but as of right now, retrieving everything requires N+1 API calls, where N is the number of task lists in a given account. So that was fairly quick. I used Google’s sample code almost verbatim for OAuth 2.0 authentication (yay security!) and that’s usually the slowest part of the application. It does cache credentials, but still takes a bit of time to establish a secure connection. Once all the data is retrieved, I decided to store it in memory as a dict of dict of lists of task objects – which are just dicts themselves. That’s a lot of dictionaries, but it made sense since I was able to get to fast accesses, insertions, and deletions. As part of the way I implemented the code, the dictionary of tasks had to be an OrderedDict; if you look at the code, it’ll make sense why. I then performed changes on the in-memory task lists as the user made changes, but those changes were only reflected via flag statuses and not actually performed. Then, when the application is closed, I sent back just the changes, minimizing the number of total API calls.


The result is a little application that I’m fairly proud of. It does what I need it to do and I actually do use it. There’s currently no documentation beyond what’s in the source code and the code is still a bit rough around the edges. The link to my repository is here. As mentioned on that page, this application requires Python >=2.7, Google API client for Python, and the Fabulous library (used for having bold and strike-through text in the terminal). I have not included the Client ID, Client Secret, or Developer Key values in this code, but you can get those values by registering this application for yourself via the Google API Console. The code itself is fully open-source and you are free to use or modify it as you wish. It’s still in development, so look out for changes in the future.


Posted by on May 31, 2011 in Uncategorized


Tags: , , , , ,

3 responses to “Tasky: A CLI Google Tasks Client in Python

  1. ProfElm

    June 20, 2011 at 3:08 PM

    Hey there! I have been wanting to do the same thing as you are doing, except that I was also thinking of developing a UI for it somewhere down the road.

    I was just going over your code and was reading that you didn’t include the clientID, clientSecret, nor the API key. To get around this, I modified the code a bit so that the user is prompted to enter their own information.

    However, the problem that I am facing at the moment is that I am able to get authenticated but can not have any interactions with the tasks.

    I have pasted the code. I am currently using python 2.7 and the google python api. After I enter the API key, the whole thing just closes down on me. Any ideas as to why this might happen?

    Here is the link to my repository:

    Looking forward to hearing from you,

    • jrupac

      June 20, 2011 at 3:24 PM

      Hey there!

      The reason I did not include those details is that this is still very much a work in progress and I did not want anyone to accidentally corrupt/lose their data as a result. Of course, these details can be gotten from the Google API Console, which you’ve figured out. The way the authentication is supposed to work is that on a first-run, the program launches a web page, from which you allow this application to access your credentials. Then, the application writes this data to a file (tasks.dat). On future runs, this file is loaded and authentication happens seamlessly. Are there any error messages when the application closes? Also, just checked out your repo. I have a GitHub mirror here in case you wanted to fork the project, etc. See if just pasting in the relevant values for ID, secret, and key into the code directly makes it work for you.

      I should also note that I only tested this on Ubuntu 11.04.

      • ProfElm

        June 20, 2011 at 3:59 PM

        You ol’ hound!

        I pasted in my information and that worked fine! It’s weird though. Is there any way that we can chat instantaneously (Say Google Chat)? 😀

        When I tried using your updated version of tasky, I came across the problem of not having the GNU Readline Library installed. I tried to install it in Windows XP but ran across some issues. Since I’m currently doing this from a work machine, I’ll have to go ahead and give it a shot at home, where I am also running Ubuntu 11.04. 🙂


Leave a Reply

Fill in your details below or click an icon to log in: Logo

You are commenting using your account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: