Garmin Connect to Obsidian without Health Sync
Garmy vault/Guides/Garmin Connect to Obsidian without Health Sync
Guides/garmin-to-obsidian-without-health-sync.md

Garmin Connect to Obsidian without Health Sync

Properties
compares
GarmyGarmin Health Sync
data source
Garmin's official Personal API
works with existing notes
key needed for existing notes
checked on
Garmy 1.1.2

Garmin Health Sync is a good plugin. Garmy covers a different part: it builds the dashboard from your own Garmin data, and it loads that data from Garmin's official Personal API. This page says what each one does and how Garmy works with notes Health Sync already wrote.

The first step of the Garmy wizard in Obsidian
Step 1 of the Garmy wizard.

Two ways to get the numbers

  • A plugin or script that writes Garmin numbers into your daily notes. Garmin Health Sync is one. Your notes get properties such as steps or sleep_score, and you chart them any way you like.
  • Garmy. It reads Garmin's official Personal API with a key you create in Garmin Connect. It never asks for your Garmin password. It writes one note per day under Garmy/data and then builds a dashboard of Dashy blocks from those notes.

The two overlap in places. Health Sync is a good plugin, and if your notes already hold what you need, you may want nothing else. The part Garmy adds is the dashboard: a wizard picks sports and metrics, previews the result on your numbers and writes the blocks into a note.

Which one for what

You wantUse
A ready dashboard from your numbersGarmy. The wizard writes it, and a rebuild later regenerates it.
Numbers already in your daily notesKeep them. Garmy can build the dashboard from those notes, no key and no loading.
Training Readiness or a VO2 max numberGarmy cannot give you these: Garmin's Personal API has neither. Check what Health Sync writes.
A full daily distanceGarmy writes no distance_km, because the range endpoints report walking distance only.
Your own chartsEither. Garmy's note is plain YAML you can edit, and the day notes are plain properties.

What Garmy writes

One note per day, with a property only when Garmin returns the number:

Garmy/data/2026-11-06.md
---
steps: 10866
resting_hr: 49
stress: 32
body_battery: 84
sleep_score: 79
sleep_duration: "7h 5min"
hrv: 61
run_km: 10.4
run_min: 51
---

Example values. The property names match the ones Health Sync notes carry, and sleep_duration is text like 7h 43min, so a template that reads one reads the other.

1Build a dashboard from notes you already have

This is the mode for Health Sync users. Open Garmy: Build a Garmin dashboard. Under the key field, Already have Garmin numbers in your notes? has a Look for those notes button.

The first wizard step with the key field and, below it, the section Already have Garmin numbers in your notes with a Look for those notes button
The button is at the bottom of step 1.

2Pick the folder

Garmy lists the folders it found, with a note count: Found in these folders. Click one. A folder qualifies when:

  • it holds at least five notes that count;
  • each note has a date in its name: 2026-11-06, or the format of your daily notes from Daily notes or Periodic Notes, such as 06.11.2026. Formats with month or weekday names are not read;
  • each note carries at least two metrics Garmy knows: steps, resting_hr, stress, body_battery, sleep_score, sleep_duration, hrv, training_readiness, distance_km, or the per sport fields run_km, run_min, bike_km, bike_min, swim_km, swim_min, strength_min.

The scan reads note properties from Obsidian's cache, opens no file and keeps nothing. It runs only when you click the button.

3Choose, preview, create

The wizard skips the key and the load and goes to Choose. It offers what the notes hold. If they carry training_readiness or distance_km, the dashboard uses them, which the Personal API route cannot. The dashboard's source: points at your folder, and the rebuild command reads that same folder later.

Running both

By default Garmy writes to Garmy/data, so the two never touch each other's notes. If you point Garmy's data folder at notes that already carry your values, Garmy fills missing properties in older days and overwrites the three most recent days with Garmin's latest numbers. Use the existing-notes mode instead when you only want the dashboard.

What Garmy leaves out

  • Training Readiness and VO2 max, from Garmin's side.
  • distance_km, for the reason above.
  • Coaching. It draws your numbers and does not interpret them.
  • Phones: not tested yet.