Garmin detiene i dati più ricchi nella tecnologia di allenamento per il pubblico: frequenza cardiaca, ritmo e potenza registrati ogni secondo, fasi del sonno, stato HRV, carico di allenamento. Naturalmente vuoi che ChatGPT li esamini. Il problema è che Garmin è la piattaforma più diffusa più difficile da connettere a un assistente IA, e a marzo 2026 è diventata ancora più difficile, quando un cambiamento di autenticazione lato Garmin ha interrotto la maggior parte degli strumenti non ufficiali da un giorno all'altro.
Costruiamo un coach di corsa collegato a Garmin, quindi conosciamo queste difficoltà in prima persona. Questa guida copre i cinque percorsi esistenti, quanto ognuno costa in termini di sforzo e cosa ognuno perde. Aggiornata a luglio 2026 con il percorso più recente: un connettore MCP.
Inizia qui: non esiste un'API personale Garmin
Strava consegna (o almeno lo faceva) ai singoli sviluppatori un token in pochi minuti. L'equivalente di Garmin, il Connect Developer Program, è una cosa diversa. Copre cinque API (Health, Activity, Training, Courses e Women's Health) ed è gratuito, ma le FAQ del programma sono schiette riguardo a chi è destinato: "è solo per uso aziendale". Si fa domanda come azienda, si riceve una chiave di valutazione con limiti al numero di richieste e si ottengono le credenziali di produzione solo dopo che Garmin ha esaminato la propria integrazione.
Non esiste un livello per hobbisti e nessun token self-service. Quindi quasi ogni configurazione personale da ChatGPT a Garmin aggira l'API ufficiale piuttosto che passarci attraverso, ed è esattamente il motivo per cui questo spazio è così traballante.
Un dettaglio che vale la pena conoscere perché indica la direzione di Garmin: il programma ha funzionato su OAuth 1.0a per anni e sta finalmente ritirandolo alla fine del 2026 a favore di OAuth 2.0 con PKCE. Garmin sta modernizzando la porta ufficiale mentre rende più difficile l'accesso da quelle non ufficiali.
Percorso 1: Esporta da Garmin Connect
Il percorso manuale. Ogni pagina di attività in Garmin Connect (web) può esportare in tre modi: Esporta originale ti dà uno ZIP con il file .fit grezzo registrato dal tuo orologio, inoltre ci sono Esporta in TCX ed Esporta in GPX. La pagina dell'elenco delle attività può anche scaricare un CSV di righe di riepilogo. E nascosto nel centro di gestione dell'account c'è l'esportazione GDPR completa ("Esporta i tuoi dati"), che arriva via email entro un giorno o due e contiene ogni file FIT che tu abbia mai registrato insieme a dati sul sonno, stress e Body Battery.
Per alimentare ChatGPT, TCX è il formato più pratico per una singola attività poiché trasporta riepiloghi per giro e frequenza cardiaca senza essere binario. Ma valgono gli stessi limiti che incontriamo altrove: un file di trackpoint completo è enorme, e incollarne uno grezzo spende l'intera finestra di contesto sulle coordinate GPS. In pratica si riassume prima e si incolla il riepilogo, il che significa che hai già fatto metà dell'analisi da solo.
Va bene per una domanda occasionale su un allenamento. Insostenibile come routine.
Percorso 2: Analizza i file FIT da solo
Se vuoi il segnale reale, la frequenza cardiaca, la cadenza e la potenza al secondo, lavori direttamente con il file FIT. FIT è un formato binario compatto; ChatGPT non può leggerlo direttamente. L'SDK FIT gratuito di Garmin fornisce FitCSVTool, che converte FIT in CSV, e il mondo open-source ha parser in ogni linguaggio. Una nota se cerchi Python: fitparse, la libreria che ogni vecchio tutorial raccomanda, è semi-abbandonata (il suo stesso README lo dice e indica fitdecode invece).
Calcoli delle dimensioni, in modo da sapere con cosa hai a che fare: un'ora di corsa con registrazione di 1 secondo sono circa 3600 messaggi di record, ognuno dei quali contiene una dozzina di campi. Come CSV, sono pochi megabyte. Molti orologi usano la Smart Recording come impostazione predefinita, che registra meno punti, ma in entrambi i casi non lo incolli in una chat. La mossa è ridurre i dati a riepiloghi per chilometro: passo medio, frequenza cardiaca media e massima, tempo in zona, deriva della frequenza cardiaca tra la prima e la seconda metà. Una tabella di 15 righe come quella è qualcosa su cui un modello può effettivamente ragionare.
Il problema è che ora hai costruito una piccola pipeline ETL, va eseguita manualmente ed elabora un'attività alla volta. Nel momento in cui vuoi "le ultime quattro settimane", stai scrivendo script che elaborano tutti i file FIT di una cartella. Non hai collegato ChatGPT a Garmin; sei diventato il connettore.
Percorso 3: Librerie non ufficiali e il blocco di marzo 2026
Per anni la risposta pragmatica è stata una libreria Python che si connette a Garmin Connect con le proprie credenziali ed estrae qualsiasi cosa l'app possa vedere: attività, sonno, HRV, Body Battery. L'ecosistema (python-garminconnect, GarminDB e altri) si basava principalmente su una libreria di autenticazione condivisa chiamata garth che impersonava l'app mobile Garmin.
Poi questa primavera Garmin ha rafforzato la sua protezione contro i bot di Cloudflare con il fingerprinting TLS, e l'impersonificazione dell'app mobile ha smesso di funzionare. Il 17 marzo 2026, gli utenti di python-garminconnect hanno aperto un problema segnalando che il codice funzionante aveva iniziato a restituire 401, meno di un giorno dopo la modifica lato Garmin. Dieci giorni dopo garth è stato formalmente deprecato, il suo README ora si apre con la parola DEPRECATED.
La storia ha un secondo atto: python-garminconnect è sopravvissuto ricostruendo il suo login su curl_cffi, che impersona l'app Android ufficiale a livello TLS. A partire dalla v0.3.5 (rilasciata il 4 giugno 2026) funziona di nuovo, gestisce l'MFA tramite una callback e memorizza i token localmente. È un progetto mantenuto in modo impressionante. È anche un progetto la cui funzione principale è una corsa agli armamenti con le difese contro i bot di Garmin, e ha perso quella corsa per circa due settimane questa primavera.
Questa è la cornice onesta per l'intero percorso: la tua password Garmin si trova in uno script, la cosa può rompersi un martedì qualsiasi senza preavviso e non esiste un SLA perché non esiste un accordo. I server Garmin MCP che troverai su GitHub (Taxuspt/garmin_mcp e una mezza dozzina di simili, molti dei quali ChatGPT può raggiungere tramite il suo supporto MCP in modalità sviluppatore) si basano quasi tutti su queste stesse librerie non ufficiali, quindi ereditano la stessa fragilità.
Percorso 4: Passaggio tramite un'altra piattaforma
Due passaggi intermedi degni di nota.
Da Garmin a Strava. Garmin sincronizza automaticamente le attività con Strava, e Strava storicamente aveva l'API personale facile, quindi il modello classico era Garmin → Strava → ChatGPT. I dati fondamentali della corsa sopravvivono al passaggio, inclusa la potenza nativa della corsa. Ciò che non sopravvive: Training Load e Status, stato HRV, Body Battery, sonno, andamento VO2max, Tempo di recupero. In altre parole, le analisi Firstbeat che giustificano l'acquisto di un Garmin in primo luogo rimangono a casa. C'è anche una nuova complicazione: la politica API di Strava del 1° giugno 2026 ora proibisce di alimentare i dati della sua API ad applicazioni IA, quindi l'ultimo tratto del passaggio intermedio ha ora i suoi problemi.
Da Garmin ad Apple Health. Su iOS, Garmin Connect scrive passi, distanza, frequenza cardiaca giornaliera, sonno con fasi e riepiloghi degli allenamenti in HealthKit, che puoi esportare ed elaborare. Non scrive HRV, stress, Body Battery, carico di allenamento o dinamiche di corsa. Stessa forma del passaggio intermedio Strava: i dati base fluiscono, le cose buone no.
Percorso 5: un connettore MCP che fa il lavoro per te
MCP, il Model Context Protocol, è diventato il modo standard in cui ChatGPT e Claude ottengono accesso in tempo reale a dati e strumenti esterni, e quel modello sta iniziando a raggiungere anche i dati Garmin. È il percorso più nuovo qui, quindi vale la pena essere precisi su ciò che esiste e ciò che non esiste.
Garmin stessa non ha ancora un server MCP ufficiale. C'è una richiesta di funzionalità aperta per uno nei forum degli sviluppatori di Garmin, senza una tempistica pubblica allegata. Ciò che esiste invece si divide in due campi, e nessuno dei due è comodo. Alcuni connettori di terze parti semplicemente chiedono il tuo nome utente e password Garmin effettivi, che è il problema di fiducia del Percorso 3 che indossa un'etichetta MCP. Altri sono legittimi ma fai-da-te: clona un repository, registra un'app per sviluppatori, gestisci i tuoi token API e un ambiente Python, che è di nuovo il Percorso 2, solo con un wrapper MCP in cima.
Il connettore di Vertical prende l'altra strada. L'accesso è OAuth, quindi ChatGPT e Claude non vedono mai la tua password Garmin, e si sincronizza direttamente con il tuo account Garmin invece di effettuare lo scraping dell'app mobile. La differenza più importante si manifesta in ciò che il modello riceve effettivamente: invece di un dump JSON grezzo di campi che dovresti interpretare da solo, ottiene analisi di livello coach, carico di allenamento, suddivisioni per zona, dove una sessione si inserisce nel tuo piano, già elaborati. Ed è l'unico percorso in questa intera guida che chiude il ciclo anche nell'altro senso: può inviare un allenamento strutturato al tuo orologio. È ora in accesso anticipato, raggiungibile da dentro ChatGPT e dentro Claude.
Nel frattempo, Garmin vende la propria IA
Merita un paragrafo perché spiega il panorama. A marzo 2025 Garmin ha lanciato Connect+, un abbonamento da $6.99/mese la cui caratteristica principale è "Active Intelligence", approfondimenti generati dall'IA sul tuo allenamento. L'accoglienza è stata dura; la recensione di TechRadar della funzione è apparsa con il titolo "finora esilarantemente brutta", e gli utenti di lunga data erano scontenti di vedere il software a pagamento. Garmin ha continuato a espanderlo da allora. Trai le tue conclusioni, ma questo ti dice perché Garmin non si sta affrettando a rendere facile l'integrazione di ChatGPT, e perché così tanti corridori stanno cercando di collegarlo da soli.
Domande comuni
ChatGPT può leggere direttamente un file FIT? No. FIT è binario. Convertilo con FitCSVTool dell'SDK FIT o un parser come fitdecode, quindi sottocampiona in righe per giro o per km prima di incollare, altrimenti il file sommergerà la finestra di contesto.
Esiste un'API Garmin ufficiale che posso usare per i miei dati? Non come individuo. Il Connect Developer Program è solo per aziende, con una richiesta di accesso, una chiave di valutazione e una verifica prima dell'uso in produzione. Le configurazioni personali si basano su esportazioni o librerie non ufficiali.
Qual è il percorso più semplice che si aggiorna automaticamente? Il passaggio tramite Strava, con due avvertenze: le metriche esclusive di Garmin non vengono trasferite e la politica API di Strava del 2026 ora limita l'uso dei dati API da parte dell'IA.
C'è qualcosa che può inviare un allenamento al mio Garmin? Solo i partner dell'API ufficiale di Training, che consente alle app approvate di pubblicare allenamenti strutturati nel calendario Connect per la sincronizzazione con l'orologio. Nessuna configurazione basata su chat può farlo, e nessuna libreria non ufficiale lo fa in modo affidabile. Il connettore MCP di Vertical è un'eccezione, attualmente in accesso anticipato.
Esiste un server MCP ufficiale di Garmin? No. C'è una richiesta di funzionalità aperta per uno nei forum degli sviluppatori di Garmin, e Garmin non l'ha ancora rilasciato. I connettori non ufficiali che colmano la lacuna richiedono principalmente il tuo accesso Garmin effettivo, lo stesso problema di fiducia delle librerie non ufficiali nel Percorso 3.
Cosa significa tutto questo
Ogni percorso descritto ti affida il lavoro di integrazione: esportare, convertire, riassumere, incollare di nuovo, gestire uno scraper attraverso la prossima modifica dell'autenticazione di Garmin. E quasi tutto risolve solo la lettura. Scrivere, mettere la sessione di domani sul tuo orologio con obiettivi di ritmo e frequenza cardiaca, passa attraverso un'API partner approvata che nessuna configurazione personale tocca, con il connettore MCP del Percorso 5 come unico percorso che salta completamente il copia-incolla e anche scrive, mentre è ancora in accesso anticipato.
Questa asimmetria è il motivo per cui abbiamo finito per costruire Vertical nel modo in cui l'abbiamo fatto: una connessione Garmin ufficiale, i dati a piena fedeltà su ogni corsa, un piano che si adatta a ciò che è realmente accaduto e il prossimo allenamento consegnato al tuo polso, ora raggiungibile direttamente da ChatGPT. I percorsi fai-da-te ci hanno insegnato esattamente quali parti di questo non possono essere fai-da-te. Se stai valutando il percorso fai-da-te rispetto a un'opzione appositamente costruita, guarda anche come Vertical si confronta con Garmin Coach.