mekk.nozbe2xmind makes it possible to view and even edit projects and actions from as XMind mind-map file.

Nozbe is web-based GTD implementation (to-do list organised around the GTD concepts of projects, actions, contexts, next actions etc) I was using for some time.

XMind is a nice, cross-platform, freely available mindmapping application.

Nozbe2XMind is able to export all active Nozbe projects and actions, and save them as a XMind mind map (I find such a view to be very useful while reviewing my todo-s), it is also able to save back some mind-map edits.


You must have reasonably modern (2.5 or 2.6) Python installed, together with SetupTools, lxml and Twisted libraries.


pip install mekk.nozbe2xmind


The program is a command-line script, you run it in the Linux terminal (or Windows console).


nozbe2xmind --help

for some help.

Download (map creation)

To download your Nozbe projects and actions, and create mind-map out of them, run:

nozbe2xmind download --user=YourNozbeNick --map=mynozbe.xmind

On the first run you will be asked for your Nozbe password (for future runs it will be preserved in appropriate keyring).


Edit the map in xmind. You can freely rename projects and actions, move (drag&drop) actions between projects, edit tags (by editing project labels), mark actions as completed (by assigning the check mark to them), etc. Refer to the Help tab in the generated mind-map for more details.

At any time you can run:

nozbe2xmind info --map=mynozbe.xmind

to check which of your changes are recognized by the script.

Upload (saving changes back to Nozbe)


nozbe2xmind upload --user=YourNozbeNick --map=mynozbe.xmind

The script will upload back to Nozbe changes you made (it will rename projects and actions, move actions between projects and so on).

Note: the change-detection algorithm is forgiving, it ignores the changes it does not understand.

Bug reporting

Use the project issue tracker to report bugs and suggest enhancements.

Before reporting the bug try running the script with --verbose option to get more detailed transcript of what happened.

Source code

Complete source code of the project is available on BitBucket. The project is split into three parts:

Additional information

More elaborate, although not completely up to date, documentation is available on my blog, see all articles about this tool.