−61%Holiday Watchface Bundle: 12 tarcz Garmin + 2 świąteczne gratis – 19,99 € zamiast 51,38 €Holiday Bundle: 12 tarcz Garmin + 2 gratis – 19,99 €

Garmin Personal API: twoje dane, czytane przez asystenta AI

Od października 2026 każdy użytkownik Garmin Connect może utworzyć osobisty klucz API i pobrać swoje aktywności, sen, HRV i Body Battery jako dane. Sam klucz nie wystarczy jednak czatowi AI: jakiś program musi wymienić go na token i pobrać dane. Tu znajdziesz, co API naprawdę zwraca, jak utworzyć klucz i który sposób połączenia pasuje do Claude, ChatGPT albo innego asystenta.

Jak to działa

  1. Garmin Connecttwoje konto
  2. Osobisty klucz APIwidoczny tylko raz
  3. Token dostępuważny 24 godziny
  4. Twoje danepliki JSON i FIT
  5. Asystent AItylko czyta

Klucz tworzysz raz na stronie Garmin Connect. Program wymienia go na token dostępu ważny 24 godziny i odczytuje nim twoje dane z Garmin: JSON dla danych o zdrowiu i podsumowań aktywności, oryginalny plik FIT dla każdej nagranej aktywności. Niczego nie da się zapisać z powrotem. Asystent AI widzi tylko to, co pobrał program.

Co możesz pobrać

Każdy zestaw danych sprawdziliśmy na prawdziwym koncie 18 listopada 2026. Środkowa kolumna to najdłuższy zakres dat, jaki przyjmuje jedno zapytanie; dłuższy okres pobierasz w częściach.

DaneNa zapytanieCo zawierają
AktywnościCała historia, strona po stronieDystans, tempo, tętno i strefy, obciążenie treningowe i efekt treningowy; szczegóły i okrążenia; oryginalny plik FIT
Sen1 noc albo 1 miesiąc podsumowańSen głęboki, płytki, REM i czuwanie, zapotrzebowanie na sen
HRVDo 1 roku podsumowańŚrednia z nocy, średnia 7-dniowa, wartość bazowa i status
Body Battery1 miesiąc (31 dni)Naładowanie, zużycie i wartości w ciągu dnia
Stres i kroki28 dniWartości dzienne
Podsumowania dniaDo 1 rokuBody Battery, tętno, stres, minuty intensywności, oddech, Pulse Ox, kalorie
VO2 maxDo 1 rokuWartości dla biegania i kolarstwa
Tętno, SpO21 dzieńTętno spoczynkowe, wartości w ciągu dnia, średnie SpO2
Poza tym—Waga, nawodnienie, strefy tętna, wiek sprawnościowy, cykl menstruacyjny, dziennik żywienia, ustawienia profilu

Garmin nie publikuje limitów zapytań, a regulamin pozwala mu zmieniać je w każdej chwili.

Czego nie dostaniesz

Te dane zwróciły w teście «nie znaleziono» albo w ogóle nie wchodzą w zakres osobistego klucza:

  • Gotowość do treningu i status treningowy
  • Prognozy czasów wyścigów i rekordy osobiste
  • Zapisane treningi, kalendarz treningowy, sprzęt i lista twoich urządzeń
  • Wszystko, co zapisuje: AI nie wyśle treningu ani trasy na zegarek. Do tego potrzebne są interfejsy Training API i Courses API Garmina, dostępne tylko dla zatwierdzonych partnerów biznesowych.
  • Dane na żywo: dane pojawiają się dopiero po synchronizacji zegarka i tylko wtedy, gdy program o nie poprosi.

✓ VO2 max jest dostępne, choć niektóre wczesne poradniki twierdzą inaczej.

Krok 1: utwórz klucz

  1. Otwórz Garmin Connect w przeglądarce na komputerze i zaloguj się.
  2. Przejdź w ustawieniach do strony osobistego klucza API (link poniżej).
  3. Wybierz «Utwórz klucz» i przeczytaj dodatkowe warunki: klucz jest tylko dla ciebie i nie wolno go nikomu przekazywać.
  4. Wybierz, jak długo ma działać: 30, 90 lub 180 dni albo 1 rok. Wybierz najkrótszy okres, który ci wystarczy.
  5. Skopiuj klucz od razu i zapisz go w menedżerze haseł. Garmin pokazuje go tylko raz; jeśli go zgubisz, usuń go i utwórz nowy.

Otwórz stronę osobistego klucza API →

Około tygodnia przed wygaśnięciem klucza Garmin wysyła e-mail. Usunięcie klucza od razu wyłącza go razem ze wszystkimi tokenami utworzonymi z jego pomocą.

Krok 2: daj asystentowi AI dostęp do danych

Ani Claude, ani ChatGPT nie użyją klucza samodzielnie. Wybierz sposób dopasowany do aplikacji, z której korzystasz.

  • Najprościej i najbezpieczniej

    Asystent, który uruchamia polecenia na twoim komputerze

    Claude Code, OpenAI Codex CLI, Cursor i podobne narzędzia potrafią uruchomić oficjalnego klienta wiersza poleceń od Garmina. Zainstaluj go (Python 3.12 lub nowszy), zapisz klucz jako jedną linię w ~/.config/garmin/connect-personal-api-key i poproś asystenta, by użył gc-personal. Klucz zostaje w pliku, a asystent czyta JSON wypisany przez klienta.

    python3 -m pip install garmin-connect-personal-api-python
    chmod 600 ~/.config/garmin/connect-personal-api-key
    gc-personal sleep-summaries \
      --start-date 2026-10-21 --end-date 2026-11-17
  • Lokalny serwer

    Claude Desktop i inne aplikacje z MCP

    Claude Desktop czyta zewnętrzne dane przez serwery MCP działające na twoim komputerze. Garmin nie ma oficjalnego; kilka serwerów open source korzysta z Personal API. Wybierz taki, którego kod możesz przeczytać, zostaw go tylko do odczytu i wpisz klucz w jego lokalną konfigurację, nie do czatu.

  • Przesłanie pliku

    ChatGPT, Gemini i inne czaty w przeglądarce

    Czat w przeglądarce nie dotrze do programu na twoim komputerze. Wyeksportuj dane oficjalnym klientem i dołącz plik JSON do czatu. Własne konektory w ChatGPT wymagają serwera w internecie, a to oznacza twój klucz na tym serwerze.

    gc-personal --quiet body-battery \
      --start-date 2026-10-18 --end-date 2026-11-17 \
      > body-battery.json

✕ Nigdy nie wklejaj klucza do czatu, na zrzut ekranu ani do udostępnianego dokumentu.

✓ Daj AI dane, nie klucz.

Oficjalny klient Garmina na GitHubie →

Konektory w chmurze a regulamin Garmina

Niektóre serwisy oferują, że połączą Garmin z ChatGPT lub Claude za ciebie. Jeśli serwis prosi o wklejenie osobistego klucza API, przekazujesz go osobie trzeciej. Dodatkowe warunki Garmina na to nie pozwalają, a klucz może zostać unieważniony. Serwisy działające w ramach programu biznesowego Garmina proszą o zgodę przez własny zatwierdzony dostęp i nigdy nie potrzebują twojego osobistego klucza. Zanim się zarejestrujesz, sprawdź, z którym rodzajem masz do czynienia.

Pytania, które działają

Poproś w jednej wiadomości o pobranie danych i analizę. Kilka pomysłów:

  • Pobierz podsumowania snu i Body Battery z ostatnich 4 tygodni. Po których nocach regenerowałem się najgorzej i co robiłem dzień wcześniej?
  • Wypisz moje biegi z tego roku z dystansem, tempem i średnim tętnem. Czy przy tym samym tempie moje tętno spada?
  • Porównaj mój status HRV z ostatnich 3 miesięcy z tygodniowym obciążeniem treningowym.
  • Pobierz plik FIT mojego ostatniego długiego biegu i pokaż tempo i tętno na każdym kilometrze.
  • Pobierz mój stres z ostatnich 3 miesięcy w częściach po 28 dni i powiedz, które dni tygodnia są najcięższe.

Zadbaj o bezpieczeństwo danych

  • Klucz otwiera dostęp do twoich danych o zdrowiu. Przechowuj go jak hasło i ustaw najkrótszą ważność, która wystarczy.
  • Pliki z kluczem mają być czytelne tylko dla ciebie (chmod 600) i trzymaj je z dala od gita, folderów w chmurze i udostępnianych kopii zapasowych.
  • To, co czyta AI, trafia do jej dostawcy. Sprawdź ustawienia danych, na przykład czy czaty służą do trenowania modeli.
  • Projekt skończony? Usuń klucz na stronie osobistego klucza API.

Pytania

Czy Garmin Personal API jest darmowe?

Tak. Każde konto Garmin Connect może utworzyć osobisty klucz, bez wniosku i bez konta deweloperskiego.

Z którymi zegarkami to działa?

API czyta Garmin Connect, a nie zegarek, więc obejmuje wszystko, co twoje zegarki tam zsynchronizowały. To, jakie wskaźniki są dostępne, zależy od modelu: status HRV czy Body Battery pojawią się tylko wtedy, gdy twój zegarek je mierzy.

Czy ChatGPT albo Claude mogą coś zmienić na moim koncie Garmin?

Nie. Osobisty klucz pozwala tylko czytać. Nie wyśle na zegarek treningów, tras ani ustawień.

Jak długo działa token dostępu?

24 godziny albo do wygaśnięcia klucza, jeśli nastąpi wcześniej. Tokenów odświeżania nie ma: program prosi kluczem o nowy token, a oficjalny klient Garmina robi to za ciebie.

Zgubiłem klucz. Czy mogę go zobaczyć jeszcze raz?

Nie. Garmin pokazuje klucz tylko raz. Usuń go i utwórz nowy.

Czy mogę widzieć Body Battery albo HRV na samym zegarku?

Tak. Wiele tarcz pokazuje je prosto na nadgarstku; przefiltruj katalog według swojego zegarka.

Powiązane poradniki

Sprawdzone 18 listopada 2026 na prawdziwym koncie w Personal API Garmina. Garmin może zmienić zestawy danych i limity.

WatchFaceKit nie jest powiązany z Garmin, Anthropic ani OpenAI. Garmin i Garmin Connect to znaki towarowe Garmin Ltd. lub jej spółek zależnych, Claude to znak towarowy Anthropic, ChatGPT to znak towarowy OpenAI.