Connect Polar to the freddy CLI

Polar tracks sleep, recovery, training load, and continuous heart rate across runs, rides, and strength sessions.

Get started free

What you can do with Polar data in the freddy CLI

• Query your Polar workouts from a terminal with `freddy query`
• Pipe your Polar heart rate into a script for a headless agent
• Query your Polar training load from a terminal with `freddy query`
• Pipe your Polar sleep into a script for a headless agent
• Query your Polar recovery from a terminal with `freddy query`

Set up in a few steps

1. Install the freddy CLI: run npm i -g @freddy-coach/cli (or use npx @freddy-coach/cli).
2. Sign in with the connection scope: freddy login --scope "mcp account:read connections:write".
3. Connect Polar: run freddy connect with its slug (freddy providers lists them), then approve in the browser.
4. Read your data: run freddy metrics to see what is available, then freddy query --metrics hrv,sleep_duration --days 7.
5. From a headless agent, run the same commands with --json for machine-readable output.

Polar through the CLI. After signing in, run freddy connect polar and approve in the browser. Polar's AccessLink API is open and gives freddy sleep stages, Nightly Recharge, cardio load, continuous heart rate, and HRV in ms_rmssd, depending on your device; Vantage and Grit X models expose the fullest set. Run freddy metrics to see the exact names your hardware reports.