michel-orgmode /

Filename Size Date modified Message
18 B
- ignore pyc files
32 B
adding __init__.py and license file.
19 B
Fixing manifest warning
3.8 KB
merge with online modifications
8.4 KB
Add support for task due dates (deadlines)
585 B
add six for py2 compatibility
1.5 KB
- update setup.py to require pyxdg


Michel-orgmode is a fork of michel which serves as a bridge between an org-mode textfile and a google-tasks task list. It can push/pull org-mode text files to/from google tasks, and perform bidirectional synchronization/merging between an org-mode text file and a google tasks list.



  • Pull your default task-list to an org-mode file:

        michel-orgmode --pull --orgfile myfile.org
  • Pull the default task-list from a different google account to an org-mode file:

        michel-orgmode --pull --orgfile myfile_other.org --profile other_acct
  • Push an org-mode file to your default task-list:

        michel-orgmode --push --orgfile myfile.org
  • Synchronize an org-mode file with your default task-list:

        michel-orgmode --sync --orgfile myfile.org
  • Synchronize an org-mode file with your task-list named "Shopping":

        michel-orgmode --sync --orgfile shopping.org --listname Shopping


The first time michel-orgmode is run under a particular profile, you will be shown a URL. Click it, and authorize michel-orgmode to access google-tasks data for whichever google-account you want to associate with the profile. You're done! If no profile is specified when running michel-orgmode, a default profile will be used.

The authorization token is stored in $XDG_DATA_HOME/michel/<profile-name>_oauth.dat. No other information is stored, since the authorization token is the only information needed for michel to authenticate with google and access your tasks data.

Command line options

usage: michel-orgmode [-h] (--push | --pull | --sync) [--orgfile FILE]
              [--profile PROFILE] [--listname LISTNAME]

optional arguments:
  -h, --help           show this help message and exit
  --push               replace LISTNAME with the contents of FILE.
  --pull               replace FILE with the contents of LISTNAME.
  --sync               synchronize changes between FILE and LISTNAME.
  --orgfile FILE       An org-mode file to push from / pull to
  --profile PROFILE    A user-defined profile name to distinguish between
                       different google accounts
  --listname LISTNAME  A GTasks list to pull from / push to (default list if

Org-mode Syntax

This script currently only supports a subset of the org-mode format. The following elements are mapped mapped between a google-tasks list and an org-mode file:

  • Task Indentation <--> Number of asterisks preceding a headline
  • Task Notes <--> Headline's body text
  • Checked-off / crossed-out <--> Headline is marked as DONE

Installation Dependencies

The michel.py script runs under Linux (not tested on other platforms yet). To run the script, you need to install the following dependencies:



  • License: Public Domain
  • Original author: Christophe-Marie Duquesne (blog post)
  • Author of org-mode version: Mark Edgington (bitbucket site)


Patches are welcome, as long as they keep the source simple and short.