Skip to content
Create a gist now

Instantly share code, notes, and snippets.

@kbl /
Last active

Embed URL


Subversion checkout URL

You can clone with
Download ZIP
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?


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


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.



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?


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'])

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.


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

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'])

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!


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?


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 :+1:


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:


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.



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!!!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Something went wrong with that request. Please try again.