Verbind Je Garmin met Claude in 3 Stappen (Geen Programmeerkennis Nodig)

Dag 102: Verbind je Garmin met Claude in 3 stappen

Eerdere Garmin School-gidsen toonden hoe je een ZIP-bestand exporteert uit Garmin Connect en aan Claude geeft. Dat werkt, maar het is een momentopname — je moet telkens opnieuw exporteren voor verse data. Een MCP-server maakt die stap overbodig: hij verbindt Claude rechtstreeks met je Garmin-account, zodat hij je laatste activiteiten, slaap, HRV, stress en trainingsdata op aanvraag kan ophalen, in elk gesprek, zonder dat je iets moet exporteren.

Wat is MCP?

Model Context Protocol (MCP) is een open standaard waarmee AI-assistenten zoals Claude kunnen verbinden met externe databronnen en tools. Een "Garmin MCP-server" is een klein programma dat aan de ene kant MCP spreekt en aan de andere kant de Garmin Connect API — Claude stelt een vraag, de server haalt het antwoord op uit je Garmin-account. Deze gids gebruikt het gratis open-source project garmin_mcp. Geen programmeerkennis nodig — elke stap hieronder is copy-paste.

Stap 1: Open een terminal

Op Mac: Druk op Cmd + Spatie, typ Terminal en druk op Enter.

Op Windows: Druk op de Windows-toets, typ PowerShell en druk op Enter.

Stap 2: Installeer uv (een klein vereist hulpprogramma)

De Garmin MCP-server draait via uv, een gratis tool die hem voor je downloadt en uitvoert — inclusief Python zelf, dus je hoeft Python niet apart te installeren. Plak de opdracht voor jouw systeem in de terminal die je net opende en druk op Enter:

Mac:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows (PowerShell):

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Er scrollt wat tekst voorbij — dat is normaal. Zodra het stopt en je een nieuwe cursor ziet, is het klaar. Dit moet je maar één keer doen op deze computer.

Stap 3: Log in bij Garmin, vanuit de terminal

Plak in datzelfde terminalvenster dit en druk op Enter (de eerste keer kan het een minuutje duren, want hij downloadt dan ook automatisch een kleine Python-runtime):

uvx --python 3.12 --from git+https://github.com/Taxuspt/garmin_mcp garmin-mcp-auth

Het vraagt om je Garmin-e-mailadres, wachtwoord en — als je die hebt ingeschakeld — je MFA-code. Typ ze in en druk telkens op Enter. Dit bewaart een beveiligd inlogtoken op je computer, ongeveer zes maanden geldig, zodat Claude je nooit meer opnieuw hoeft te laten inloggen.

Stap 4: Download de Garmin MCP-extensie

Ga naar de Releases-pagina van het project en download het nieuwste garmin-mcp.dxt-bestand, te vinden onder "Assets".

Stap 5: Installeer hem in Claude Desktop

Open de Claude desktop-app (download en installeer die eerst als je dat nog niet deed), en sleep het garmin-mcp.dxt-bestand dat je net downloadde rechtstreeks naar het Claude Desktop-venster. Je kan het bestand ook dubbelklikken, of via Instellingen → Extensies → Extensie installeren handmatig kiezen.

Claude toont een kort configuratiescherm voor de extensie, met optionele velden zoals token-pad, e-mail of wachtwoord. Omdat je al inlogde in Stap 3, laat je elk veld leeg en bevestig je gewoon — Claude gebruikt automatisch je opgeslagen login.

Stap 6: Herstart Claude Desktop

Sluit Claude Desktop volledig af en open het opnieuw, en start een nieuw gesprek. Je Garmin-data — recente activiteiten, slaapfases, HRV-status, stress, Body Battery, trainingsbelasting en -paraatheid, VO2 max-trends en meer — is nu rechtstreeks beschikbaar voor Claude, zonder export en zonder copy-paste.

Als er iets misgaat

• Zegt Claude dat hij uvx niet kan vinden, typ dan which uvx (Mac) in de terminal, kopieer het pad dat verschijnt, en plak dat volledige pad in het "command"-veld van de extensie in plaats van uvx.
• Je inlogtoken blijft ongeveer zes maanden geldig. Ziet Claude plots je data niet meer, herhaal dan gewoon Stap 3.

Probeer het: vind patronen in je slaap

Hier is een prompt die de verbinding meteen aan het werk zet. Hij combineert je slaap met je overdag-training en stress — niet gewoon een lijst slaapscores — en vraagt om een net Word-document terug:

Analyze my last 14 days of sleep data alongside my daytime activity, training, and stress data to find patterns — not just a summary of sleep scores. Produce the result as a clean, well-formatted document (Word doc), not a chat reply.

Pull for each of the last 14 days:
- Sleep score, total sleep time, sleep stages (deep/light/REM/awake), overnight HRV, resting HR
- Bedtime and wake time (consistency/variability)
- That day's training load, activity type, intensity, and time of day it happened
- Daytime stress levels and Body Battery (start, end, charge/drain pattern)
- Any logged alcohol, caffeine, or late meals if available

Then do two things:
1. Pattern analysis — find the 2-3 strongest correlations across the 14 days (e.g. training timing vs. sleep score, stress vs. deep sleep %, bedtime consistency vs. sleep quality), each backed by specific data points.
2. Best night / worst night deep dive — identify my single best and single worst sleep night in this period. For each one, reconstruct that full day: what I did, when, training load, stress, Body Battery trend, bedtime. Then explain why that night likely turned out the way it did, connecting the dots between the day's data and the sleep outcome — don't just restate the numbers, explain the mechanism (e.g. "late intense training kept HR elevated into the evening, delaying the drop needed for deep sleep").

Structure the document as:
- Summary (3-4 sentences, plain language)
- 14-day data table (date, sleep score, key metrics, notable daytime factors)
- Pattern analysis section
- Best night breakdown
- Worst night breakdown
- 2-3 practical adjustments to test, based on the above

Keep language direct and practical, no fluff.

Geef het een minuutje om de data op te halen en uit te schrijven. Omdat Claude je Garmin-account rechtstreeks leest, kan je meteen een vervolgvraag stellen — "en de twee weken daarvoor?" — zonder opnieuw iets te exporteren.