Skip to content
Script that take a gmail mbox file and pushes its content to imap (tags are transformed into folders)
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


gmail-mbox-to-imap is an adaptation of IMAP upload in order to transform Gmail tags into folders.

IMAP upload:, by OZAWA Masayuki


git clone
cd gmail-mbox-to-imap


You will need to grab your Gmail's messages in mbox format. Go to, create an archive containing your mails, download it and unzip it.


./ --ssl --password=your-password migration-from-gmail.mbox

More options with:

./ --help



Google translates its labels in your native language. For example, in french, Inbox is called "Boîte de Réception". Plus, in the X-Gmail-Labels, the encoding seems to be not well interpreted, so I use regexes to translate "Boîte de Réception" to "INBOX", the absence of the "Non lus" label adds a "\Seen" flag to the, and some other fixes.

So, if you're not french, edit the script around the line 166 and change regexes to match your language.

If someone knows Python well and want to create some sort of localization function that use the good regex for a chosen language : welcome aboard !

###Strange behavior

When trying the script, it seems to let a lot of mails unseen while they were already seen. I don't know why. Again, if you know Python, welcome aboard !


gmail-mbox-to-imap is released under the terms of the MIT license. See License.txt for details.

You can’t perform that action at this time.