Twoje dane
Aktywności, tętno, sen, HRV i inne dane dostępne w oficjalnym Personal API Garmina.
Połącz swoje dane Garmin z asystentem AI i pytaj o trening, sen oraz regenerację. Krok po kroku, na własnym serwerze.
Oficjalny Garmin Personal API · tylko odczyt · projekt open source
Garmin zbiera wiele informacji. MCP to pomost, dzięki któremu wybrany asystent może odczytać je wtedy, gdy o to poprosisz — i pomóc Ci dostrzec zależności.
Aktywności, tętno, sen, HRV i inne dane dostępne w oficjalnym Personal API Garmina.
Serwer działa na Twoim koncie Cloudflare. Klucz Garmina zapisujesz jako sekret, a dostęp zatwierdzasz samodzielnie.
Zapytaj o ostatnie treningi, porównaj tygodnie i sprawdź zmiany w regeneracji.
Instrukcja nie wysyła danych do autora tej strony. Twój serwer działa na Twoim koncie Cloudflare. Gdy pytasz asystenta, potrzebne dane są przekazywane z Garmina przez Cloudflare do dostawcy wybranego asystenta AI.
Nie wklejaj klucza Garmin, tokenów ani kodów logowania do czatu lub formularza na tej stronie. Nie podawaj ich również agentowi wdrażającemu.
Potrzebujesz kont Garmin Connect i Cloudflare, komputera z przeglądarką, terminala oraz konta w wybranym asystencie. Poniższa ścieżka korzysta z Cloudflare. Nazwy opcji w panelach mogą się zmienić.
Zainstaluj Node.js, Git oraz pnpm. Projekt wskazuje wersje w plikach .node-version i package.json. Otwórz terminal i uruchom:
git clone https://github.com/lukasamd/garmin-mcp.git cd garmin-mcp corepack enable pnpm install --frozen-lockfile pnpm check pnpm wrangler login
Otworzy się logowanie Cloudflare. Zaloguj się samodzielnie i zatwierdź dostęp. Jeżeli polecenie instalacji lub logowania nie działa, skorzystaj z promptu dla agenta poniżej.
workers.dev, skonfiguruj ją. Utwórz Worker garmin-mcp z szablonu „Hello World”.garmin-mcp.TWOJA-SUBDOMENA.workers.dev./authorize. Dodaj regułę Allow → Emails z Twoim adresem e-mail; wybierz logowanie jednorazowym kodem (One-time PIN)./authorize. Przed stroną Workera powinien pojawić się ekran Cloudflare Access. Jeśli nie, popraw regułę.Chroń ścieżkę /authorize, nie cały Worker: klient MCP musi dotrzeć do /mcp i endpointów OAuth. Na chronionej stronie możesz zatwierdzić klienta po sprawdzeniu jego nazwy i adresu.
pnpm wrangler secret put ACCESS_AUD. Wklej AUD dopiero w odpowiedzi na ukryty monit i zatwierdź.pnpm wrangler secret put GARMIN_API_KEY. Wklej klucz dopiero w odpowiedzi na ukryty monit i zatwierdź. Nie dopisuj go do polecenia.Jeśli masz już aktywny klucz Personal API, sprawdź skutki jego zastąpienia dla innych połączeń. Traktuj klucz jak hasło.
W tym samym katalogu uruchom:
pnpm wrangler deploy
Jeśli Wrangler zapyta o utworzenie KV, potwierdź. Skopiuj adres swojego Workera i dopisz /mcp. Sprawdź, czy bez logowania endpoint odrzuca żądanie:
curl -sS -o /dev/null -w 'HTTP %{http_code}\n' https://TWOJ-WORKER.workers.dev/mcpOczekiwane: HTTP 401. Sam ten wynik nie potwierdza poprawności pozostałych zabezpieczeń. Po podłączeniu klienta sprawdź również odczyt aktywności, snu i HRV.
ChatGPT: w Plugins wybierz dodanie własnego serwera MCP, wklej adres kończący się na /mcp, wybierz OAuth i przejdź autoryzację. Dostępność opcji może zależeć od konta. Nasz test z kontem Plus w Work zakończył się powodzeniem.
Claude: w Connectors wybierz dodanie własnego konektora, wpisz adres MCP i przejdź autoryzację. Anthropic podaje dostępność również w planie Free, z limitem jednego własnego konektora. Przed rozpoczęciem sprawdź aktualne wymagania.
Gemini: dostępność własnych aplikacji MCP jest ograniczona. Google opisuje obecnie m.in. wymaganie przebywania w USA, konto osobiste i język angielski; sprawdź bieżące warunki. Gemini CLI jest osobnym narzędziem. Zgodność tych klientów z tą konfiguracją wymaga testu.
Podczas autoryzacji sprawdź nazwę aplikacji i adres docelowy na stronie zgody. Po zmianie listy narzędzi może być wymagane jej odświeżenie lub rozpoczęcie nowej rozmowy.
Możesz użyć agenta programistycznego do przeprowadzenia konfiguracji lub poprosić podłączonego asystenta o analizę. Dane dostępowe wprowadzaj samodzielnie.
Pomóż mi uruchomić prywatny, tylko do odczytu serwer Garmin MCP z https://github.com/lukasamd/garmin-mcp na Cloudflare Free. Najpierw sprawdź README i warunki mojego środowiska. Prowadź mnie etapami i wyjaśniaj prosto. Nie proś o hasła, klucz Garmin, tokeny ani kody w rozmowie i ich nie zapisuj w repozytorium ani logach. Logowanie, akceptację warunków oraz wpisanie sekretów wykonam samodzielnie. Skonfiguruj Cloudflare Access tylko dla /authorize oraz OAuth dla /mcp. Przed publikacją sprawdź konfigurację, nie udostępniaj moich danych innym osobom. Po wdrożeniu sprawdź brak dostępu bez tokenu oraz, po mojej autoryzacji, odczyt aktywności, HRV i snu. Nie deklaruj sukcesu bez testów.
Korzystając z mojego Garmin MCP, przeanalizuj ostatnie cztery pełne tygodnie treningu. Porównaj liczbę i czas treningów, dystans oraz intensywność biegania i jazdy. Uwzględnij sen, HRV oraz ewentualne luki w danych. Pokaż zakres dat i oddziel obserwacje od przypuszczeń. Zaproponuj ostrożne kierunki treningu na kolejny tydzień, zaznaczając, że nie znasz wszystkich czynników wpływających na regenerację.
Projekt jest open source. Cloudflare oferuje plan Free z limitami; dostępność konta i warunki usług mogą się zmieniać. Asystent może mieć własne ograniczenia lub wymagać odpowiedniego planu. Duże pliki FIT mogą przekroczyć limity darmowego Workera.
Istnieją lokalne serwery MCP i rozwiązania uruchamiane w Dockerze. Ten projekt jest jednak oparty na Workers, Cloudflare KV i Access; przeniesienie go wymaga zmian w kodzie i zabezpieczeniach. Nie przedstawiamy jeszcze innej ścieżki jako przetestowanej.
Odłącz aplikację w wybranym asystencie. Klucz Garmin możesz usunąć w ustawieniach Personal API, co unieważnia powiązane tokeny Garmin. Nowy klucz wpisz poleceniem pnpm wrangler secret put GARMIN_API_KEY. Aby unieważnić wszystkich klientów OAuth tego Workera, wyczyść jego namespace KV — ponowna autoryzacja będzie potrzebna wszystkim klientom. Nie usuwaj innych zasobów KV.
Ten serwer udostępnia tylko dane obsługiwane przez jego narzędzia. VO₂ max może być dostępne, jeśli Garmin zwróci dane. Bezpośredniego odczytu Training Readiness obecny serwer nie wystawia; analiza snu i HRV nie jest jego dokładnym odpowiednikiem.