https://github.com/jagbanana/jg-garmin-to-sheets
Export Garmin data to Google Sheets utility
https://github.com/jagbanana/jg-garmin-to-sheets
fitness garmin garmin-connect google-sheets health
Last synced: about 1 month ago
JSON representation
Export Garmin data to Google Sheets utility
- Host: GitHub
- URL: https://github.com/jagbanana/jg-garmin-to-sheets
- Owner: jagbanana
- License: mit
- Created: 2025-01-13T01:01:43.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2025-03-09T21:07:53.000Z (about 2 months ago)
- Last Synced: 2025-03-09T22:19:15.497Z (about 2 months ago)
- Topics: fitness, garmin, garmin-connect, google-sheets, health
- Language: Python
- Homepage: https://jaglab.org/garmin-to-sheets/
- Size: 191 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Garmin Data to Google Sheets Utility
A Docker-based command-line tool that pulls daily health metrics from Garmin Connect and stores them in Google Sheets.
I created this utility to feed data into an LLM (e.g. Claude, ChatGPT, or Gemini) so that I could gain insights for improving my health and longevity.
## Screenshots
Running the utility in PowerShell:
*Simple command line utility to pull daily data from Garmin and store it in a Google Sheet.*
The result:
*Your Garmin data is now in a Google Sheet ready for additional analysis.*
## Prerequisites
- Docker installed on your system or Python 3.9 or higher (if running without Docker)
- A Garmin Connect account
- A Google account with access to Google Sheets
Note: some users have reported challenges with the refreshing auth tokens in the Docker version of this app. If you face this, instead run the app directly with Python (see below after step 4).
## Setup Instructions
### 1. Clone the Repository
```bash
git clone https://github.com/yourusername/garmin-sync.git
cd garmin-sync
```
### 2. Set Up Google Sheets API
1. Go to the [Google Cloud Console](https://console.cloud.google.com/)
2. Create a new project or select an existing one
3. Enable the Google Sheets API for your project
4. Create credentials (OAuth 2.0 Client ID):
- Click "Create Credentials" > "OAuth client ID"
- Choose "Desktop app" as the application type
- Download the client configuration file
5. Create a new directory called `credentials` in the project root
6. Move the downloaded file into the `credentials` directory and rename it to `client_secret.json`
### 3. Configure Environment Variables
1. Copy the example environment file:
```bash
cp .env.example .env
```
2. Edit `.env` with your credentials:
```
# Garmin Connect credentials
[email protected]
GARMIN_PASSWORD=your_password
# Google Sheets
GOOGLE_SHEETS_ID=your_sheet_id
GOOGLE_CREDENTIALS_DIR=credentials
GOOGLE_CLIENT_SECRET_FILE=client_secret.json
GOOGLE_TOKEN_FILE=token.pickle
```
To get your Google Sheets ID:
1. Create a new Google Sheet
2. The ID is in the URL: `https://docs.google.com/spreadsheets/d/[THIS-IS-YOUR-SHEET-ID]/edit`
### 4. Build and Run with Docker
1. Build the Docker image:
```bash
docker build -t garmin-sync .
```
2. Run the sync tool:
```bash
docker run -v $(pwd)/credentials:/app/credentials -v $(pwd)/.env:/app/.env garmin-sync --start-date 2024-01-01 --end-date 2024-01-31
```
Replace the dates with your desired date range. The tool can run a year of dates at a time.
### Running Without Docker
These steps are only if you prefer not to use Docker. This is more complex and not tested.
1. Create a virtual environment:
```bash
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
```
2. Install dependencies:
```bash
pip install -r requirements.txt
```
3. Run the sync tool:
```bash
python -m src.main --start-date 2024-01-01 --end-date 2024-01-31
```
## Available Metrics
The tool syncs the following daily metrics from Garmin Connect:
- Sleep Score
- Sleep Length
- Weight
- Body Fat Percentage
- Blood Pressure (Systolic/Diastolic)
- Active/Resting Calories
- Resting Heart Rate
- Average Stress
- Training Status
- VO2 Max (Running/Cycling)
- Intensity Minutes
- Activity Counts and Distances/Durations (Running, Cycling, Strength, Cardio)
These metrics were chosen specifically because they relate to long-term health and longevity planning.
## Troubleshooting
1. Authentication Issues:
- Ensure your Garmin credentials are correct in `.env`
- For Google Sheets issues, delete `token.pickle` and try again
2. Permission Issues:
- Ensure the credentials directory is mounted correctly in Docker
- Check that your Google account has edit access to the sheet
## Security Notes
- Never commit your `.env` file or anything in the `credentials` directory
- Keep your Google client secret and credentials secure
- The tool uses environment variables for all sensitive data
## Known Issues
Data prior to May 14, 2023 does not work with this tool yet. If you put earlier dates, the utility will just create blank rows.
## License
This project is licensed under the MIT License - see the [LICENSE.md](LICENSE.md) file for details.