GMvault
GMvault is a command-line tool for backing up Gmail accounts and restoring a local email repository to Gmail.
What GMvault is
GMvault is a command-line tool for backing up Gmail accounts and restoring a local email repository to Gmail. It supports full synchronization and incremental quick synchronization, giving users two ways to keep a local copy of their correspondence current. The tool is free and open source under GNU-AGPL-3.0, with versions for Linux, macOS, and Windows. Its project documents binary installations for those systems, as well as installation from source with Python, pip, or easy_install.
XOAuth is the recommended authentication method and is enabled by default; after the first sign-in, its token is stored in $HOME/.gmvault for later use. Users may instead authenticate with a Gmail login password, which can be encrypted if saved. Emails go by default to $HOME/gmvault-db, or %HOME%/gmvault-db on Windows. For restores, --resume and --restart options help avoid uploading messages that have already been processed. PyPI lists version 1.9.1 as the latest release, published March 31, 2016.
Good
- Free and open source under GNU-AGPL-3.0
- Offers full and incremental synchronization
- Can restore a local repository to Gmail
- Resume and restart options for restore operations
Watch out
- Command-line interface rather than a graphical one
- Supports Gmail as its listed provider
- Latest listed release dates to March 31, 2016
Who it suits
GMvault suits Gmail users who want a local backup and a way to restore it to their account. It is a fit for people comfortable using a command-line tool on Linux, macOS, or Windows.
Verdict
GMvault provides Gmail backup and restore through a free command-line tool, with full and incremental sync options. Its listed latest release is from 2016, a detail to weigh when considering it.
Plans and prices
From GMvault's own pricing page, checked 1 Oct 2026.
| Plan | Price | What it gives you |
|---|---|---|
| Gmvault | Free | open source · GNU Affero General Public License v3 |
The facts
Each one read from GMvault's own pages, with the date it was checked.
What it does
- Authentication
- XOAuth is the recommended authentication method and is enabled by default.checked 1 Oct 2026
- Installation
- Users can install from source with python setup.py install or through pip and easy_install.checked 1 Oct 2026
- Interface
- Gmvault is a user-friendly command-line tool.checked 1 Oct 2026
- License
- Gmvault is open source and licensed under GNU-AGPL-3.0.checked 1 Oct 2026
- Local storage
- Emails are stored by default in $HOME/gmvault-db, or %HOME%/gmvault-db on Windows.checked 1 Oct 2026
- Maintainer
- The project identifies Guillaume Aubert as its development lead and creator.checked 1 Oct 2026
- Operating systems
- The project documents binary installations for Windows, Linux, and Mac OS X.checked 1 Oct 2026
- Package scope
- PyPI classifies Gmvault for Gmail, email backup, Gmail backup, and IMAP.checked 1 Oct 2026
- Password handling
- Users can authenticate with a Gmail login password, which is encrypted if they choose to save it.checked 1 Oct 2026
- Purpose
- Gmvault backs up Gmail accounts so users do not lose email correspondence.checked 1 Oct 2026
- Recovery
- Restore operations support --resume and --restart options so already processed emails do not need to be uploaded again.checked 1 Oct 2026
- Release
- PyPI lists version 1.9.1 as the latest release, published March 31, 2016.checked 1 Oct 2026
- Restore
- The tool restores a local email repository into a Gmail account.checked 1 Oct 2026
- Sync modes
- Gmvault supports full synchronization and incremental quick synchronization.checked 1 Oct 2026
- Token storage
- After first authentication, the XOAuth token is stored in $HOME/.gmvault for later use.checked 1 Oct 2026
The full review of GMvault
Overview
GMvault is a free, open-source command-line utility for backing up Gmail and restoring a local email repository to Gmail. It is best suited to people who want control of a local Gmail archive and are comfortable using a terminal. Full and incremental sync, plus restartable restores, make it a focused backup tool; its Gmail-only support and narrow purpose make it less suitable for broader email or device-backup needs.
Key features
- Full and incremental synchronization: GMvault can run a full synchronization or an incremental quick synchronization. The two modes accommodate an initial backup and subsequent syncs, though the tool remains focused on Gmail rather than offering a wider provider choice.
- Restore to Gmail: A local email repository can be restored to a Gmail account. The --resume and --restart options help avoid uploading emails that have already been processed, a practical safeguard for interrupted restore work.
- Authentication choices: XOAuth is the recommended method and is enabled by default. After the first authentication, its token is stored in $HOME/.gmvault for later use. Users can also authenticate with a Gmail login password; if they choose to save it, the password is encrypted.
- Local archive: Emails are stored by default in $HOME/gmvault-db, or %HOME%/gmvault-db on Windows. That gives the backup a defined local destination, while requiring users to manage the archive on their own system.
- Installation and licensing: Binary installations are documented for Windows, Linux and Mac OS X. Installation from source is also possible with python setup.py install, or through pip and easy_install. GMvault is licensed under GNU-AGPL-3.0; Guillaume Aubert is identified as its creator and development lead.
Pricing
GMvault costs nothing under the GNU Affero General Public License v3. There is no paid tier to weigh against the free option, so it suits users seeking a no-cost Gmail backup tool. The trade-off is scope: this is a Gmail-focused command-line utility, not a multi-provider backup service.
Platforms
GMvault supports Linux, macOS and Windows, with documented binary installations for Linux, Mac OS X and Windows. Its command-line interface and installation options make it a better fit for users comfortable with terminal-based software than for those looking for a conventional graphical backup application.
Who it's for
Choose GMvault if you use Gmail, want a local copy of your correspondence, and value the ability to restore that archive to Gmail without paying for the software. Incremental sync and restore recovery options are useful for maintaining or reapplying an archive. Look elsewhere if you need backup across email providers, a graphical interface, or a tool whose latest release is more recent: PyPI's latest version, 1.9.1, was published March 31, 2016.
Pros and cons
- Pro — Free and open source: The GNU-AGPL-3.0 license and free price make it accessible without a subscription.
- Pro — Covers backup and restore: It can sync Gmail locally and restore the repository back to Gmail, with options to avoid repeating already processed uploads.
- Pro — Multiple operating systems: Linux, macOS and Windows support gives users on those systems a way to use the same focused tool.
- Con — Gmail only: Its supported provider is Gmail, so it does not suit users looking to protect mail across providers.
- Con — Command-line workflow: Users need to be comfortable with terminal use and local archive management.
- Con — Old latest release: Version 1.9.1 dates to March 31, 2016, a concern for readers who prioritize a more recently released tool.
Alternatives
For other backup software, browse Email Backup Software. The alternatives below address different backup targets and platforms, so they are not direct Gmail-mailbox replacements in every case.
- MSP360 Backup is worth considering for personal workstation backup on Linux, macOS or Windows; its free plan includes file- and image-based backup and forum-based support. Choose it when workstation files and images, rather than Gmail correspondence, are the priority.
- VM Backup offers a free edition limited to two VMs per host, plus a 30-day fully featured trial. It is a better fit when virtual-machine backup is the need.
- Veeam Agent for Mac has a free edition limited to one backup job and no direct backup to object storage. Consider it when you need Mac backup rather than a Gmail archive.
- Datto Endpoint Backup for Windows uses consumption-based pricing billed for storage used, with pricing requested from Datto. It may suit readers looking for endpoint backup with usage-based charges.
- DRS Softech Microsoft 365 Backup Tool is a paid alternative focused on Microsoft 365 backup.
- Synology Active Backup for SaaS is a free add-on for Synology NAS covering Microsoft 365 and Google Workspace. It is a better match for users already seeking a NAS-based SaaS backup option.
- AvePoint Cloud Backup is a paid alternative with custom pricing.
- Cohesity SiteContinuity is a paid alternative for readers considering a different backup product.
Verdict
GMvault is a sensible choice for a terminal-comfortable Gmail user who wants free local backup and a way to restore that archive to Gmail. Its sync and recovery controls serve that specific job well. Choose another tool if Gmail is not your only backup target, you want a graphical workflow, or the 2016 latest release is too old for your comfort.
Getting started
- Open the GMvault website
- Choose a Windows, Linux, or Mac OS X binary
- Or install from source with python setup.py install, pip, or easy_install
- Authenticate with XOAuth or a Gmail password
- Run a full synchronization or incremental quick synchronization
- Restore the local repository to Gmail when needed
Limits worth knowing
The listed plan is free at 0.00 USD and is licensed under GNU-AGPL-3.0. Provider support is listed for Gmail.
Questions
Is GMvault free?
Yes. The listed Gmvault plan costs 0.00 USD and is open source under GNU-AGPL-3.0.
Which systems can run GMvault?
It runs on Linux, macOS, and Windows.
Where are backed-up emails stored?
The default location is $HOME/gmvault-db, or %HOME%/gmvault-db on Windows.
How does GMvault authenticate?
XOAuth is recommended and enabled by default. A Gmail login password can also be used, and saved passwords may be encrypted.
Can a backup be restored to Gmail?
Yes. GMvault restores a local email repository into a Gmail account and supports resume and restart options.
Who created GMvault?
The project identifies Guillaume Aubert as its development lead and creator.
Alternatives to GMvault
- 1

SpinOne
WebAPIExtensionLinux7.6From $3 a month - 2
Spanning Backup
AndroidiOSWebAPI7.3 - 3
Cove Data Protection
WebLinuxmacOSWindows6.9 - 4
Rubrik Security Cloud
WebAPILinuxmacOS6.9 - 5

Synology Active Backup for SaaS
Free planSelf-hosted6.7Free plan - 66.6From $18 a year