Our take
- Activity
- 19
- Community
- 4
- Issues
- 21
- Pull requests
- 20
-1 stars in the last 30 days
- Fewer contributors than 91% of the projects we track
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
468Forks
16Change since Nov 14, 2026: 0 stars·0 forks
Overview
node-google-backup is a command-line utility for backing up Google Mail, Contacts, and Calendar to local files. It syncs new mail, contacts, and events, providing a local copy for people who want to reduce their reliance on continued access to a Google account.
Backups are organized by service, with mail also arranged by ID, thread, and label. Email messages are stored as .eml files, contacts as .vcf, and calendar events as .ics.
Key Features
- Downloads Google Mail, Contacts, and Calendar data.
- Syncs only new mail, contacts, and calendar events.
- Saves mail as
.emlfiles, contacts as.vcf, and calendar events as.ics. - Organizes mail by ID, thread, and label.
- Offers both Node.js CLI and Docker usage.
- Supports scheduled runs, such as through cron.
Use Cases
- Individuals who want a local backup in case they lose access to their Google account.
- Users who want to keep mail, contacts, and calendar data together in a local backup directory.
- Administrators or technically comfortable users setting up recurring backups with cron or Docker.
Getting Started
With Node.js installed, run the utility using an Google App Password:
npx -y google-backup --username "[email hidden]" --password "your-app-password" --filepath "~/Backups/Google/"
See the README for Docker usage and further details.
Considerations
- Use of the tool requires Google account credentials and an App Password.
- The backup is written to a local path, so you are responsible for protecting and retaining those files.
- The repository is licensed under GPL-3.0. Review the license if you plan to redistribute or modify the software.
Found this useful?
Share it with someone who would like node-google-backup.