WeeJeWel

node-google-backup: Back Up Gmail, Contacts, and Calendar

A Node.js command-line tool that syncs Google Mail, Contacts, and Calendar data to local files. It suits people who want a scheduled, local copy of their Google data in standard email and contact formats.

JavaScriptGPL-3.0Node.jsCLIAutomation
View on GitHub Compare
Stars
471
Forks
16
Stars, last 30 days
-1

Our take

Health score

16/100

How it is scored
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.

Selected snapshot

Stars

468

Forks

16

Change 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 .eml files, 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.