Gebruik de Strava MCP Niet voor Garmin-data — Gebruik Dit in Plaats Daarvan

Dag 105: Gebruik de Strava MCP niet als je het volledige plaatje wil

Strava lanceerde een officiële MCP-connector voor Claude en ChatGPT, en het is een oprecht goede tool — alleen-lezen, beperkt tot je eigen account, gebouwd door Strava zelf. Maar als je een Garmin draagt, is het de verkeerde connector om naar te grijpen.

Wat de Strava MCP dekt

De connector van Strava focust op activiteitengeschiedenis, conditietrends, paraatheid, doelplanning en uitrusting — alles gekoppeld aan een gelogde training. Wat hij niet blootlegt is de herstelkant: slaapfases, nachtelijke HRV, stress of Body Battery. Die data verlaat je Garmin-account sowieso nooit.

Wat de Garmin MCP daar bovenop toevoegt

Een Garmin MCP-server geeft Claude ook je trainingsdata — activiteiten, trainingsbelasting, VO2 max, trainingsstatus — maar legt daar je volledige gezondheidsbeeld bovenop:

• Slaapfases, slaapscore en slaapconsistentie
• Nachtelijke HRV en HRV Status-trend
• Stressniveaus en Body Battery laad-/ontlaadpatronen
• Rusthartslag en trainingsparaatheid

Dat is het verschil tussen Claude die ziet wat je deed, en Claude die ziet waarom je dat wel of niet aankan. Een zware trainingsweek betekent iets heel anders in combinatie met een onderdrukte HRV-trend en slechte slaap dan in combinatie met sterke herstelcijfers.

Zo stel je het in

Dit gebruikt het gratis open-source project garmin_mcp. Geen programmeerkennis nodig — elke stap 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 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 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.

Zet het aan het werk: bouw een echt trainingsplan

Eenmaal verbonden, gebruik je deze prompt. Beschrijf eerst je doel, en laat Claude dan je echte data ophalen voor hij iets plant:

[explain your goal here, for example: run 10 miles in 6 months]

Before building a plan, pull my last 14 days of training and health data from Garmin:
- All activities: type, distance, duration, pace, average/max HR, elevation, perceived effort if logged
- Training load and Training Status (productive, maintaining, overreaching, etc.)
- VO2max trend
- Resting HR and HRV trend
- Sleep score average and consistency
- Body Battery and stress trends
- Any current injuries, pain, or recovery flags if mentioned in activity notes

Use this data to establish my current baseline fitness level, honestly — don't assume a generic starting point. Then build a training plan to reach the stated goal by the target date.

The plan should:
- Start from where my data actually shows I am now (weekly volume, pace, long-run distance, recovery capacity), not an idealized starting point
- Progress volume/intensity gradually, respecting a sensible weekly increase (~10% or less) and account for my current Training Status and recovery trends — back off progression if HRV/sleep/Body Battery show I'm already under strain
- Include a weekly structure (easy runs, one quality session, long run, rest/cross-train days) appropriate for the goal
- Flag any specific risk areas based on my data (e.g. low resting heart rate variability, poor sleep consistency, high training load already) and how the plan accounts for them
- Break the plan into phases (e.g. base building, build, peak, taper if relevant) with approximate weekly mileage/duration targets per phase
- Note 2-3 checkpoints where I should reassess (e.g. week 4, week 10) based on how my Garmin metrics are trending, not just the calendar

Output as a clean, well-formatted document (Word doc): summary of current baseline, the phased plan with a week-by-week or phase-by-phase table, key risks flagged, and reassessment checkpoints. Keep language direct and practical, no fluff.

Omdat Claude je Garmin-account rechtstreeks leest via de MCP-verbinding, is er geen exportstap en geen verouderde data — telkens je dit uitvoert, werkt hij met je laatste cijfers.