Create a gist now

Instantly share code, notes, and snippets.

@kbl /
Last active Nov 9, 2017

What would you like to do?
importing tasks/lists from wunderlist into todoist
# -*- coding: utf8 -*-
import json
import urllib2
import urllib
import sys
import os
from argparse import ArgumentParser
from collections import defaultdict
def log(message):
sys.stdout.write(message + os.linesep)
class TodoistAPI(object):
def __init__(self, email, password):
self.token = self._api_call('login', {'email': email, 'password': password}, add_token=False)['token']
def _api_call(self, api_method, parameters, add_token=True):
parameters = dict(parameters)
if add_token:
parameters.update({'token': self.token})
params = urllib.urlencode(parameters)
url = u'' % (api_method, params)
log('Calling url %s' % url)
return_value = json.load(urllib2.urlopen(url))
if type(return_value) is unicode:
raise Exception('Call finished with error! %s' % return_value)
return return_value
def add_list(self, list_name):
log('Adding list %s' % list_name)
return self._api_call('addProject', {'name': list_name})['id']
def add_task(self, list_id, task_name):
log('Adding task %s to list %d' % (task_name, list_id))
return self._api_call('addItem', {'project_id': list_id, 'content': task_name})['id']
def create_parser():
parser = ArgumentParser()
return parser
if __name__ == '__main__':
parser = create_parser()
args = parser.parse_args()
todoist_api = TodoistAPI(args.todoist_email, args.todoist_password)
with open(args.wunderlist_dump_json) as f:
j = json.load(f)
lists = {}
for l in j['lists']:
lists[l['id']] = todoist_api.add_list(l['title'])
lists['inbox'] = todoist_api.add_list('inbox')
for t in j['tasks']:
todoist_api.add_task(lists[t['list_id']], t['title'])

How do you use this?

Cjsnet commented Feb 16, 2014

No seriously, how do you use this? I need it, but am not sure where to use the code. Please explain.


kbl commented Feb 18, 2014

I'm not sure if either wunderlist's json format or todoist's API wasn't changed. If it wasn't you need:

  • export tasks from wunderlist to json,
  • place it in the same directory as this python script,
  • either rename json file to wunderlist-xxx.json or change wunderlist_dump variable value,
  • request for API (v1) token from todoist and place it in token variable,
  • $ python

I haven't used it since 6 months so I'm not sure if it still works (I'm still Todoist's happy user), I'll check it in spare time.

Cjsnet commented Feb 18, 2014


To get the API token (especially for Google login) it's easier to go to Todoist Account Settings where it is listed.

To run the script download PythonLauncher from

When I exucute the scrtip via python, I get the following error message:

Traceback (most recent call last):
  File "", line 39, in <module>
    for l in j['/me/lists']:
KeyError: '/me/lists' 

Did wunderlist possibly change their json?

vst commented Feb 22, 2014

Yep. This is how it worked for me (Note that I am not importing completed tasks):

# -*- coding: utf-8 -*-
# to get API token send request to
#<your_email>&password=<your password>
# and copy api_token field value from returned json,
# it should be sth like "2acd79190f40ee06aXXXXXXXXXXXXXXXXXXXXXXX"

import json
import urllib
import urllib2
from pprint import pprint
from collections import defaultdict

token = 'SOMETOKEN'
wunderlist_dump = 'wunderlist-DUMP.json'

def api_call(api_method, parameters):
    parameters = dict(parameters)
    parameters.update({'token': token})
    params = urllib.urlencode(parameters)
    url = u'' % (api_method, params)
    return json.load(urllib2.urlopen(url))

def add_list(list_name):
    print list_name
    return api_call('addProject', {'name': list_name.encode("utf8")})['id']

def add_task(list_id, task_name):
    print list_id, task_name
    return api_call('addItem', {'project_id': list_id, 'content': task_name.encode("utf8")})['id']

if __name__ == '__main__':
    with open(wunderlist_dump) as f:
        j = json.load(f)
        lists = {}
        for l in j['lists']:
           lists[l['id']] = add_list(l['title'])
        lists['inbox'] = add_list('inbox')
        for t in j['tasks']:
            if not "completed_at" in t and not "parent_id" in t:
                add_task(lists[t['list_id']], t['title'])

kbl commented Feb 22, 2014

I've created newer version with some UX improvements ;). Currently you don't need to fiddle with the script at all, token is retrieved automatically based on passed email and password (as this password is stored in plain text in command line history please remember to wipe it afterwards).

The problem was in changed wunderlist's json file format. Right now you could use this by calling:

python <path to wunderlist json file> <todoist account email> <todoist accout password>

I've tested in on simple account with default lists and 2 tasks - it worked.

Cjsnet commented Feb 23, 2014

Well... it sort of worked, but not really.

  • It created all the "Projects" in Todoist, but they were all empty.
  • Then it put all of those Projects's contents in "Inbox"

So the Projects have (0) and Inbox says (143).

Is that a simple fix by any chance?


kbl commented Mar 8, 2014

I tested it on the file which you provided and... it was working on my machine :/

Not working for me. Getting a 401 error.

EDIT: Worked after changing ['token'] in Line 16 to ['api_token']

Works for me, the only thing I changed was to not import completed tasks from Wunderlist. That might be what @Cjsnet was seeing too where he mentioned everything was going into the "inbox".

for t in j['tasks']:
    if 'completed_at' not in t:
        todoist_api.add_task(lists[t['list_id']], t['title'])

ludob commented Jul 13, 2014

Works well as it is for me.
Just need to edit the json file from Wunderlist because of text encoding. Special characters in French are not supported by the script (for example: à).
Otherwise, perfect, thanks a lot kbl!

ajtb commented Sep 4, 2014

Does not work for me. All I get is:

Traceback (most recent call last): File "", line 54, in <module> for l in j['lists']: KeyError: 'lists'

Any chance of checking on it kbl?

silvoc commented Sep 16, 2014

I have got the same problem....

Please kbl :)

Thanks in advance


I've updated the gist so that it fixes the issues mentioned above. It's got to do with some changes in the Wunderlist JSON structure :P

Please update the original gist with my revision 👍

duellsy commented Oct 2, 2014

I've made some more mods to this, to allow completed tasks to be marked as completed in todoist, as well as migrate over all notes:

jalyst commented Dec 18, 2014

Thanks @duellsy,

Did you also incorporate @glnarayanan's fixes? His post is just above your last post.
If you did then your script is the latest, incorporating: KBL, your, & glnarayanan's work.

jalyst commented Dec 18, 2014


I tried yours, got it going but it doesn't seem to have brought notes & sub-tasks along with it, completed task are all there I think, I can show you the output of my terminal session?

Marvelous, thanks!!!

I installed python and run the command in terminal and I got this:

Calling url
Traceback (most recent call last):
  File "", line 62, in <module>
    todoist_api = TodoistAPI(args.todoist_email, args.todoist_password)
  File "", line 16, in __init__
    self.token = self._api_call('login', {'email': email, 'password': password}, add_token=False)['token']
  File "", line 28, in _api_call
    raise Exception('Call finished with error! %s' % return_value)
Exception: Call finished with error! LOGIN_ERROR

The login info is correct I typed it as you advised:
python [wunderlist_dump.json] [wrote my email here] [wrote my password here]

Is it required to type the email and password somewhere inside .py file as well? Please advice what am I doing wrong?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment