Garmin to Notion Integration ⌚

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 ✨

🔄 Automatically sync Garmin activities to Notion in real-time
📊 Track detailed activity metrics (distance, pace, heart rate)
🎯 Extract and track personal records (fastest 1K, longest ride)
👣 Optional daily steps tracker 😴 Optional sleep data tracker
🤖 Zero-touch automation once configured
📱 Compatible with all Garmin activities and devices
🔧 Easy setup with clear instructions and minimal coding required

Prerequisites 🛠️

• 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

Getting Started 🎯

A detailed step-by-step guide is provided on my Notion template here. For more advanced users, follow these steps to set up the integration:

1. Fork this GitHub Repository

2. Duplicate my Notion Template

• Save your Activities and Personal Records database ID (you will need it for step 4)
  • Optional: Daily Steps database ID
  • Look at the URL: notion.so/username/[string-of-characters]
  • The database ID is everything after your “username/“ and before the “?v”

3. Create Notion Token

• Go to Notion Integrations.
• Create a new integration and copy the integration token.
• Share the integration with the target database in Notion.

4. Set Environment Secrets

• Environment secrets to define:
  • GARMIN_EMAIL
  • GARMIN_PASSWORD
  • NOTION_TOKEN
  • NOTION_DB_ID
  • NOTION_PR_DB_ID
  • NOTION_STEPS_DB_ID (optional)
  • NOTION_SLEEP_DB_ID (optional)

5. Run Scripts (if not using automatic workflow)

• Run garmin-activities.py to sync your Garmin activities to Notion.
  python garmin-activities.py
• Run person-records.py to extract activity records (e.g., fastest run, longest ride).
  python personal-records.py

Example Configuration 📝

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:

My Notion template is available for free and can be duplicated to your Notion here

Acknowledgements 🙌

• Reference dictionary and examples can be found in cyberjunky/python-garminconnect.
• This project was inspired by n-kratz/garmin-notion.

Contributing 🤝

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 😊

©️ License

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