Simple reading management with Wunderlist

December 31, 2016


Add books to certain list in Wunderlist, mark as done when finished reading, and retrieve completed tasks via API if you want to make list of the books you’ve read.

  • Register dummy app, and get client_id and access_token on Wunderlist’s developer’s page
  • Create list called “Reading”
  • Get some books
  • Add task like Author Name, Title, ...
  • Reading time
    • Write impressions or quote interesting part of the book, and put them into comments form in Wunderlist
  • Mark as done when finished or just got bored
  • Retrieve list via API
    • Filter by keys such as completed_at, created_at if you want…
  • Write article about books I’ve read

Script (Python 3.5)

#!/usr/bin/env python3
from requests_oauthlib import OAuth2Session
import json
import sys
from typing import Dict

def req_get(s: OAuth2Session, url: str, params: Dict=None):
    got = s.get(url, params=params)
    if got.status_code == 200:
        results = json.loads(got.text)
        return results
        sys.stderr.write("HTTP Error: {}".format(got.status_code))
        return {}

def get_id_of_list(lists: Dict, name: str):
    for d in lists:
        if d['title'] == name:
            return d['id']
    return None

if __name__ == '__main__':
    client_id = sys.argv[1]
    access_token = sys.argv[2]
    api_url = ""

    session = OAuth2Session()
    session.headers['X-Client-ID'] = client_id
    session.headers['X-Access-Token'] = access_token
    lists = req_get(session, api_url+"lists")
    reading_list_id = get_id_of_list(lists, 'Reading')

    if reading_list_id:
        params = {'completed': True, 'list_id': reading_list_id}
        books = req_get(session, api_url+"tasks", params)
        for book in sorted(books, key=lambda x: x['completed_at']):
            # Write to stdout as markdown's numbered list formatting
            print("1. " + book['title'])

©2011-2018 tuxedocat : Built with Hugo