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 Claude li esamini. Il problema è che Garmin è la piattaforma più diffusa più difficile da collegare a un assistente IA, e a marzo 2026 è diventata ancora più difficile, quando una modifica dell'autenticazione lato Garmin ha interrotto la maggior parte degli strumenti non ufficiali da un giorno all'altro.
Noi costruiamo un coach di corsa connesso a Garmin, quindi conosciamo queste difficoltà in prima persona. Questa guida copre i cinque percorsi esistenti per Claude, il costo di ognuno in termini di sforzo e cosa ognuno perde. Claude ha un vero vantaggio qui: Anthropic ha costruito MCP e Claude Desktop ha supportato server MCP locali da novembre 2024, mesi prima che altri assistenti aggiungessero qualcosa di paragonabile. Questo vantaggio cambia quali percorsi sono pratici. Aggiornato a settembre 2026.
Inizia qui: non esiste un'API personale Garmin
Strava fornisce (o almeno forniva) un token agli sviluppatori individuali in pochi minuti. L'equivalente di Garmin, il Connect Developer Program, è un sistema diverso. Comprende cinque API (Health, Activity, Training, Courses e Women's Health) ed è gratuito, ma le FAQ del programma sono chiare su 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 l'integrazione.
Non esiste un livello per hobbisti e nessun token self-service. Quindi quasi ogni configurazione personale da Claude a Garmin aggira l'API ufficiale piuttosto che passarci attraverso, ed è esattamente per questo che questo spazio è così instabile.
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 ritirando tale versione alla fine del 2026 a favore di OAuth 2.0 con PKCE. Garmin sta modernizzando la porta ufficiale mentre sta rendendo più difficile l'accesso da quelle non ufficiali.
Percorso 1: Esportazione da Garmin Connect
Il percorso manuale. Ogni pagina di attività in Garmin Connect (web) può essere esportata 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 riassuntive. E nascosta 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 Claude, TCX è il formato più pratico per una singola attività, poiché contiene riepiloghi per giro e frequenza cardiaca senza essere binario. L'ampia finestra di contesto di Claude è più indulgente con un file grezzo rispetto ad alcuni assistenti, ma valgono comunque gli stessi limiti: un file di trackpoint completo è enorme, e incollarlo grezzo occupa una gran parte del tuo contesto con coordinate GPS. In pratica, prima si riassume e poi si incolla il riassunto, il che significa che si è già fatta metà dell'analisi da soli.
Va bene per una domanda occasionale su un allenamento. Insostenibile come routine.
Percorso 2: Analizza i file FIT da solo
Se vuoi il vero segnale, frequenza cardiaca al secondo, cadenza e potenza, lavori direttamente con il file FIT. FIT è un formato binario compatto; Claude non può leggerlo grezzo. L'SDK FIT gratuito di Garmin fornisce FitCSVTool, che converte FIT in CSV, e il mondo open source ha parser in ogni linguaggio. Un appunto se usi Python: fitparse, la libreria che ogni vecchio tutorial raccomanda, è semi-abbandonata (il suo stesso README lo dice e indica fitdecode invece).
Calcoli delle dimensioni, così sai 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, registrando meno punti, ma in ogni caso 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 hai costruito una piccola pipeline ETL, che viene eseguita a mano e che 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 Claude a Garmin; sei diventato il connettore.
Percorso 3: Librerie non ufficiali, il blocco di marzo 2026 e Claude Desktop
Per anni la risposta pragmatica è stata una libreria Python che si connette a Garmin Connect con le tue credenziali e recupera tutto ciò che l'app può 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 una segnalazione riportando 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, con il suo README che ora inizia con la parola DEPRECATED.
La storia ha un secondo atto: python-garminconnect è sopravvissuto ricostruendo il suo login su curl_cffi, che simula 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.
Questo è il quadro onesto per tutto questo percorso: la tua password Garmin si trova in uno script, la cosa può rompersi un martedì qualsiasi senza preavviso, e non c'è SLA perché non c'è accordo. Claude Desktop rende la configurazione più facile rispetto ad altrove. I server Garmin MCP che troverai su GitHub (Taxuspt/garmin_mcp e una mezza dozzina di simili) si inseriscono direttamente in claude_desktop_config.json come voce di server locale, senza dover attivare la modalità sviluppatore né attendere la revisione nella directory delle app. Comodo, ma quasi tutti si basano sulle stesse librerie non ufficiali, quindi si rompono quando le librerie si rompono, e la maggior parte richiede ancora il tuo nome utente e password Garmin in chiaro in un file di configurazione su disco.
Percorso 4: Passaggio tramite un'altra piattaforma
Due passaggi intermedi meritano attenzione.
Da Garmin a Strava. Garmin sincronizza automaticamente le attività con Strava, e Strava storicamente aveva un'API personale semplice, quindi il modello classico era Garmin → Strava → Claude. Strava ha lanciato un connettore MCP ufficiale il 1° giugno 2026, e Claude è stato il suo primo client supportato. Se sei un abbonato a Strava, quel connettore è un modo autorizzato e basato su OAuth per ottenere i dati Strava in Claude oggi. È solo lettura e puoi revocarlo dalle impostazioni di Strava. Ciò che non può trasportare è tutto ciò che non ha mai lasciato i server di Garmin: Carico e Stato di allenamento, stato HRV, Body Battery, sonno, andamento VO2max, Tempo di recupero. Anche il passaggio ufficialmente autorizzato non può ancora consegnare a Claude le analisi Firstbeat che giustificano l'acquisto di un Garmin in primo luogo.
Da Garmin ad Apple Health. Su iOS, Garmin Connect scrive passi, distanza, frequenza cardiaca per tutto il giorno, 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 tramite Strava: i dati di base passano, le analisi più utili no.
Percorso 5: un connettore MCP che fa il lavoro per te
MCP porta Claude a un server, ma non dice nulla su cosa quel server restituisce. Ogni percorso finora, incluso il connettore Strava autorizzato, fornisce a Claude campi grezzi o un quadro parziale. Ciò che si trova all'altro capo della connessione è ciò che conta.
Garmin stessa non ha ancora un server MCP ufficiale. C'è una richiesta di funzionalità aperta per uno sui forum degli sviluppatori di Garmin, senza una tempistica pubblica allegata. Ciò che esiste invece si divide in due campi, e nessuno dei due è confortevole. Alcuni connettori di terze parti chiedono semplicemente il tuo nome utente e password Garmin effettivi, il 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, il che è di nuovo il Percorso 2, solo con un wrapper MCP in cima.
Il connettore di Vertical prende l'altra strada. L'accesso avviene tramite OAuth, quindi Claude non vede mai la tua password Garmin, e si sincronizza direttamente con il tuo account Garmin invece di acquisire dati dall'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 guida che chiude il ciclo anche nell'altro senso: può inviare un allenamento strutturato al tuo orologio. È ora in accesso anticipato, raggiungibile dall'interno di Claude e dall'interno di ChatGPT.
Nel frattempo, Garmin vende la sua IA
Vale la pena un paragrafo perché spiega il panorama. A marzo 2025 Garmin ha lanciato Connect+, un abbonamento da $6.99/mese la cui funzionalità principale è "Active Intelligence", approfondimenti generati dall'IA sul tuo allenamento. L'accoglienza è stata difficile; la recensione di TechRadar della funzionalità è apparsa sotto il titolo "finora esilarantemente scadente", e gli utenti di lunga data erano scontenti di vedere il software a pagamento. Da allora Garmin ha continuato ad espanderlo. Trai le tue conclusioni, ma questo ti dice perché Garmin non si sta affrettando a rendere facile l'integrazione di Claude, e perché così tanti corridori stanno cercando di collegarlo da soli.
Domande comuni
Claude può leggere direttamente un file FIT? No. FIT è binario. Convertilo con il FitCSVTool dell'SDK FIT o un parser come fitdecode, quindi sottocampiona a righe per giro o per km prima di incollare, altrimenti il file affollerà tutto il resto nel 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 connettore MCP ufficiale di Strava; Claude è stato il suo primo client supportato. Due avvertenze: le metriche esclusive di Garmin non passano a Strava e per utilizzarlo è necessario un abbonamento a Strava.
Il supporto MCP locale di Claude Desktop rende sicuro l'uso dei server Garmin non ufficiali? Più facili da configurare, non più sicuri. Inserire un server Garmin MCP in claude_desktop_config.json richiede una modifica alla configurazione, e nessuno controlla il server prima che venga eseguito. La maggior parte di questi server richiede comunque il tuo nome utente e password Garmin effettivi su disco, e si basano comunque sulle stesse librerie non ufficiali che si sono interrotte da un giorno all'altro a marzo 2026.
Qualcosa può inviare un allenamento al mio Garmin? Solo i partner dell'API ufficiale di allenamento, che consente alle app approvate di pubblicare allenamenti strutturati nel calendario Connect per la sincronizzazione con l'orologio. Nessuna libreria non ufficiale o server MCP fai-da-te lo fa in modo affidabile. Il connettore MCP di Vertical è un'eccezione, attualmente in accesso anticipato.
Esiste un server MCP Garmin ufficiale? No. C'è una richiesta di funzionalità aperta per uno sui forum degli sviluppatori Garmin, e Garmin non lo ha ancora rilasciato. I connettori non ufficiali che colmano la lacuna richiedono per lo più il tuo login 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, o accettare che anche l'unico connettore MCP autorizzato (quello di Strava) non può vedere le analisi proprie di Garmin. E quasi tutto risolve solo la lettura. La scrittura inversa, l'inserimento della 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 scrive anche, 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 Claude. I percorsi fai-da-te ci hanno insegnato esattamente quali parti di questo non possono essere fatte da soli. Se stai valutando il percorso fai-da-te rispetto a un'opzione appositamente costruita, vedi anche come Vertical si confronta con Garmin Coach.