https://github.com/chloevoyer/garmin-to-notion

Import data from GarminConnect to Notion database
https://github.com/chloevoyer/garmin-to-notion

automated garmin garmin-connect garmin-data notion notion-client python

Last synced: 25 days ago
JSON representation

Import data from GarminConnect to Notion database

• Host: GitHub
• URL: https://github.com/chloevoyer/garmin-to-notion
• Owner: chloevoyer
• License: mit
• Created: 2024-09-07T18:44:27.000Z (about 2 months ago)
• Default Branch: main
• Last Pushed: 2024-09-25T22:14:33.000Z (about 1 month ago)
• Last Synced: 2024-09-29T19:01:55.304Z (about 1 month ago)
• Topics: automated, garmin, garmin-connect, garmin-data, notion, notion-client, python
• Language: Python
• Homepage:
• Size: 151 KB
• Stars: 1
• Watchers: 1
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

README

        
[![Sync Garmin to Notion](https://github.com/chloevoyer/garmin-to-notion/actions/workflows/manual.yml/badge.svg?branch=main)](https://github.com/chloevoyer/garmin-to-notion/actions/workflows/manual.yml)

# Garmin to Notion Integration :watch:

This project connects your Garmin activities and personal records to your Notion database, allowing you to keep track of your performance metrics in one place.

## Features :sparkles:  

- Automatically sync Garmin activities to Notion.

- Extract Garmin personal records such as fastest 1K and longest ride.

- Easy setup with clear instructions and minimal coding required.

## Prerequisites :hammer_and_wrench:  

- A Notion account with API access.

- A Garmin Connect account to pull activity data.

- If you wish to sync your Peloton workouts with Garmin, see [peloton-to-garmin](https://github.com/philosowaffle/peloton-to-garmin)

## Getting Started :dart:

Follow these steps to set up the integration:

### 1. Set Environment Secrets

Ensure that your environment secrets are correctly configured for secure data access.

### 2. Create Notion Token

* Go to [Notion Integrations](https://www.notion.so/profile/integrations).

* [Create](https://developers.notion.com/docs/create-a-notion-integration) a new integration and copy the integration token.

* [Share](https://www.notion.so/help/add-and-manage-connections-with-the-api#enterprise-connection-settings) the integration with the target database in Notion.

### 3. Run Scripts (if not using automatic workflow)

* Run [garmin-activities.py](https://github.com/chloevoyer/garmin-to-notion/blob/main/garmin-activities.py) to sync your Garmin activities to Notion.  

`python garmin-activities.py`

* Run [person-records.py](https://github.com/chloevoyer/garmin-to-notion/blob/main/personal-records.py) to extract activity records (e.g., fastest run, longest ride).  

`python personal-records.py` 

## Example Configuration :pencil:    

You can customize the scripts to fit your needs by modifying environment variables and Notion database settings.  

Here is a screenshot of what my Notion dashboard looks like:  

![garmin-to-notion-template](https://github.com/user-attachments/assets/b37077cc-fe87-466f-9424-8ba9e4efa909)

My Notion template is available for free and can be duplicated to your Notion [here](https://www.notion.so/templates/fitness-tracker-738)

## Acknowledgements :raised_hands:  

- Reference dictionary and examples can be found in [cyberjunky/python-garminconnect](https://github.com/cyberjunky/python-garminconnect.git).

- This project was inspired by [n-kratz/garmin-notion](https://github.com/n-kratz/garmin-notion.git).

## Contributing :handshake:   

Contributions are welcome! If you find a bug or want to add a feature, feel free to open an issue or submit a pull request. Financial contributions are also greatly appreciated :blush:    

   

## :copyright: License  

This project is licensed under the MIT License. See the LICENSE file for more details.