{"name":"node-google-backup: Automated Local Backups for Google Mail, Calendar, and Contacts","description":"node-google-backup is a powerful command-line utility designed to automatically back up your Google Mail, Calendar, and Contacts to local files. This JavaScript-based tool ensures your critical data is safely stored offline, providing peace of mind against account lockouts or data loss. It efficiently syncs only new mails, contacts, and events, making subsequent backups quick and resource-friendly.","github":"https://github.com/WeeJeWel/node-google-backup","url":"https://osrepos.com/repo/weejewel-node-google-backup","source":"osrepos.com","sourceDescription":"This repository profile is provided by osrepos.com, an open source repository discovery platform.","repositoryProfile":"https://osrepos.com/repo/weejewel-node-google-backup","generatedFor":"open source discovery and AI-assisted research","markdown":"https://osrepos.com/repo/weejewel-node-google-backup.md","json":"https://osrepos.com/repo/weejewel-node-google-backup.json","topics":["JavaScript","Google","Backup","CLI","Mail","Calendar","Contacts","Data Security"],"keywords":["JavaScript","Google","Backup","CLI","Mail","Calendar","Contacts","Data Security"],"stars":null,"summary":"node-google-backup is a powerful command-line utility designed to automatically back up your Google Mail, Calendar, and Contacts to local files. This JavaScript-based tool ensures your critical data is safely stored offline, providing peace of mind against account lockouts or data loss. It efficiently syncs only new mails, contacts, and events, making subsequent backups quick and resource-friendly.","content":"## Introduction\n\n`node-google-backup` is an efficient command-line utility developed by WeeJeWel, designed to automate the backup of your Google Mail, Calendar, and Contacts to local files. This JavaScript-based tool ensures your valuable data is securely stored offline, offering peace of mind against potential account lockouts or data loss. It intelligently syncs only new mails, contacts, and events, making subsequent backup operations fast and resource-efficient. With 408 stars and 16 forks, it's a well-regarded project licensed under GPL-3.0.\n\nThe utility creates a structured local directory, organizing your data into `Contacts` (VCF files), `Calendar` (ICS files), and `Mail` (EML files, categorized by ID, Thread, and Label).\n\n## Installation\n\nBefore running `node-google-backup`, you need to create a Google App Password. This provides a secure way for the utility to access your Google services without using your main account password. You can generate one at [https://myaccount.google.com/apppasswords](https://myaccount.google.com/apppasswords){:target=\"_blank\"}.\n\nOnce you have your App Password, you can run the utility using Node.js or Docker.\n\n## Examples\n\n### Node.js\n\nIf you have Node.js installed, you can execute the utility directly using `npx`:\n\nbash\n$ npx -y google-backup \\\n  --username \"john.doe@gmail.com\" \\\n  --password \"abcd efgh ijkl mnop\" \\\n  --filepath \"~/Backups/Google/\"\n\n\nThis command will download your Google data to the specified `filepath`. For automated backups, consider scheduling this command as a cron job.\n\n### Docker\n\nFor those who prefer containerized environments, `node-google-backup` is also available as a Docker image:\n\nbash\n$ docker run \\\n  --env GOOGLE_BACKUP_USERNAME=\"john.doe@gmail.com\" \\\n  --env GOOGLE_BACKUP_PASSWORD=\"abcd efgh ijkl mnop\" \\\n  --env GOOGLE_BACKUP_FILEPATH=\"/backups\" \\\n  --env GOOGLE_BACKUP_SERVICES=\"mail,calendar,contacts\" \\\n  --volume=\"~/Backups/Google/:/backups/\" \\\n  ghcr.io/weejewel/google-backup\n\n\nThis Docker command mounts a local directory to store the backups and uses environment variables for configuration.\n\n## Why Use It?\n\nWhile Google provides excellent services, there are numerous accounts of individuals being locked out of their accounts, leading to potential loss of critical personal data. `node-google-backup` addresses this concern by empowering you to maintain local copies of your Google Mail, Calendar, and Contacts. This ensures that you always have access to your data, regardless of your Google account status, providing an essential layer of personal data security and control.\n\n## Links\n\n*   **GitHub Repository:** [https://github.com/WeeJeWel/node-google-backup](https://github.com/WeeJeWel/node-google-backup){:target=\"_blank\"}\n*   **NPM Package:** [https://npmjs.com/package/google-backup](https://npmjs.com/package/google-backup){:target=\"_blank\"}\n*   **Create Google App Password:** [https://myaccount.google.com/apppasswords](https://myaccount.google.com/apppasswords){:target=\"_blank\"}\n*   **Related Project, iCloud Backup:** [https://github.com/WeeJeWel/node-icloud-backup](https://github.com/WeeJeWel/node-icloud-backup){:target=\"_blank\"}","metrics":{"detailViews":11,"githubClicks":10},"dates":{"published":null,"modified":"2025-10-12T03:40:22.000Z"}}