Naar de inhoud
OpenAthlete

MCP-server

Je training, in Claude en ChatGPT

Koppel de assistent waar je al voor betaalt aan OpenAthlete. Hij leest je agenda, activiteiten en vorm, en plant met jouw toestemming een blok van 12 weken rechtstreeks in je agenda. Van daaruit gaan de trainingen naar je horloge.

  • 25 tools
  • Gratis bij elk abonnement
  • OAuth, lezen en schrijven gescheiden
Claude · OpenAthlete

Maak een schema van 12 weken voor een marathon op 14 maart, 5 lopen per week, lange duurloop op zondag.

  • get_athlete_contextzones, VMA, vorm −6
  • get_training_volumelaatste 12 weken
  • plan_sessions60 trainingen, 4 blokken

Je schema staat in de agenda: 60 trainingen in 4 blokken, drempel op dinsdag, lange duurlopen van 1u30 tot 2u50 op zondag, elke vierde week lichter, twee weken taper. De trainingen komen op je Garmin naarmate hun datum nadert.

In één alinea

Wat MCP is

Het Model Context Protocol is een open standaard waarmee een AI-assistent tools kan gebruiken die een andere app aanbiedt. OpenAthlete is een MCP-server: eenmaal gekoppeld kunnen Claude of ChatGPT functies zoals get_training_load of plan_sessions op je account aanroepen, zoals jij door de app zou klikken. Het model draait aan de kant van je assistent, dus OpenAthlete betaalt er niets voor, en jij ook niet: de MCP-server is gratis bij elk abonnement, zelf gehoste instanties inbegrepen.

Voorbeelden

Wat je kunt vragen

Vier verzoeken en de tools die de assistent aanroept om ze te beantwoorden.

“Maak een schema van 12 weken voor een marathon op 14 maart, 5 lopen per week, met mijn lange duurloop op zondag.”

get_athlete_context→get_training_load→get_training_volume→plan_sessions

“Ik heb sinds gisteren koorts. Pas mijn komende twee weken aan.”

create_period→get_calendar→move_sessions→update_session

“Hoe ging vorige week vergeleken met het schema? Is mijn vorm goed voor de wedstrijd van zaterdag?”

get_calendar→get_activity→get_training_load

“Mijn nieuwe FTP is 265 W: leg hem vast en werk mijn vermogenszones bij.”

log_metrics→update_training_zone

Tools

25 tools: agenda, belasting, activiteiten, planning

Trainingen worden gelezen en geschreven in gewone eenheden: duur in seconden, tempo's als 4:35 per km, je zones op id, of percentages van VMA, FTP of maximale hartslag. Datums staan in jouw tijdzone.

Leestoegang

read · 12
  • get_athlete_context

    Datum en tijdzone van vandaag, metingen, zones, fitheid en vorm, de laatste 4 weken, komende wedstrijden, periodes en blessures. Agents roepen dit als eerste aan.

  • get_calendar

    Geplande trainingen (gedaan, gemist of te doen), wedstrijden, notities, activiteiten en periodes tussen twee datums.

  • get_sessionget_activity

    De gestructureerde training van een sessie; de ronden van een activiteit en je antwoorden op de vragen na de activiteit.

  • get_activitiesget_training_volume

    Trainingshistorie en weekvolume per sport.

  • get_training_load

    Weekbelasting, gedaan en gepland, met fitheid, vermoeidheid en vorm doorgetrokken over de geplande trainingen.

  • get_metricsget_capacitiesget_records

    Historie van metingen (gewicht, rusthartslag, HRV, slaap), capaciteiten en beste prestaties.

  • list_workout_templateslist_athletes

    Je trainingsbibliotheek; voor coaches de atleten die ze coachen.

Schrijftoegang, daarbovenop

write · 11
  • plan_sessions

    Voegt tot 60 trainingen met gestructureerde opbouw, wedstrijden en notities tegelijk toe. Alles wordt opgeslagen, of niets.

  • update_session

    Wijzigt een training, een wedstrijd of een notitie; bij een herhaalde training deze en de volgende.

  • move_sessionscopy_sessionsrepeat_session

    Verplaatst of kopieert trainingen met een aantal dagen, herhaalt er een om de paar weken.

  • delete_sessions

    Verwijdert geplande trainingen. Gedane trainingen en opgenomen activiteiten worden nooit verwijderd.

  • create_periodupdate_perioddelete_period

    Trainingsblokken, en periodes zonder training: reizen, ziekte, blessure.

  • log_metricsupdate_training_zone

    Legt metingen vast, wijzigt een zone na een test.

Instellen

Gekoppeld in twee minuten

Het adres is overal hetzelfde. Op een zelf gehoste instantie is het https://<jouw domein>/api/mcp.

Installatiehandleiding
URLhttps://api.openathlete.org/mcp

Claude

claude.ai en de desktopapp, daarna ook op mobiel. Eén eigen connector met het gratis abonnement

  1. 1Customize › Connectors › Add custom connector
  2. 2Plak het adres, dan Connect
  3. 3Log in bij OpenAthlete en kies Toestaan
Stapsgewijze handleiding

ChatGPT

Business-, Enterprise- en Edu-abonnementen toen we het controleerden; Pro kan alleen lezen

  1. 1Plugins › + › Add custom MCP server
  2. 2Plak het adres, kies OAuth, maak het aan als plugin
  3. 3Sta het toe in OpenAthlete
Stapsgewijze handleiding

Claude Code

In een terminal, dan /mcp om in te loggen

claude mcp add --transport http openathlete https://api.openathlete.org/mcp

Cursor, VS Code, je eigen agent

OAuth als de client het ondersteunt, anders een persoonlijke token uit Instellingen › AI-agents, één keer getoond

{
  "mcpServers": {
    "openathlete": {
      "url": "https://api.openathlete.org/mcp",
      "headers": { "Authorization": "Bearer oa_pat_..." }
    }
  }
}

Voor coaches

Werk met al je atleten tegelijk

De assistent van een coach bereikt de atleten die hij coacht, met dezelfde regels als in de app. Hij zet ze op een rij en geeft bij elk verzoek de atleet mee. Vraag om een terugblik op ieders week, of herwerk het blok van één atleet na een flinke verkoudheid.

OpenAthlete voor coaches
ChatGPT · OpenAthlete

Hoe verliep vorige week voor elk van mijn atleten vergeleken met het schema?

  • list_athletes6 atleten
  • get_calendar× 6, vorige week

Vier van de zes haalden 90% of meer van de geplande tijd. Léa miste beide kwaliteitstrainingen en schreef donderdag "kuit stijf". Marc deed 30% meer dan gepland.

Beveiliging

Beveiliging en toestemmingen

Wat een assistent met je gegevens doet, is aan hem en zijn aanbieder. Koppel alleen de assistenten die je vertrouwt.

OAuth 2.1 met PKCE: je keurt elke assistent goed op een pagina van OpenAthlete. Hij ziet nooit je wachtwoord.

Lezen en schrijven zijn gescheiden. Een assistent met leestoegang krijgt de tools die schrijven niet eens aangeboden.

Tokens worden gehasht opgeslagen. Toegangstokens zijn een uur geldig; vernieuwingstokens zijn eenmalig, en een gestolen token die twee keer wordt gebruikt, trekt de toegang in.

Persoonlijke tokens zijn 30, 90 of 365 dagen geldig, of verlopen nooit. Trek elke koppeling in via Instellingen › AI-agents; ze stopt bij het volgende verzoek.

Assistenten bereiken je training, niet je account: geen wachtwoordwijziging, geen wijziging van apparaat of abonnement, geen verwijdering van je historie.

Veelgestelde vragen

Ja, bij elk abonnement, Gratis inbegrepen, en op zelf gehoste instanties. Het model draait aan de kant van je assistent, onder je Claude- of ChatGPT-account.

Claude (claude.ai, desktop, mobiel en Claude Code), ChatGPT in ontwikkelaarsmodus, Cursor, VS Code en elke MCP-client die OAuth of een bearer-token ondersteunt.

Nee. Gedane trainingen en opgenomen activiteiten zijn je historie en zijn via MCP alleen-lezen. Hij kan alleen trainingen wijzigen of verwijderen die nog moeten komen.

Ja, precies zoals de trainingen die je zelf plant: naar Garmin, Suunto of COROS als het exporteren van trainingen aanstaat.

Ja. Keur alleen de leesscope goed, of maak een persoonlijke token met leestoegang. De assistent kan dan niets wijzigen.

Ja. Het adres is https://<jouw domein>/api/mcp, met dezelfde OAuth-flow en tools.

Geef je assistent iets echts om mee te werken

Maak een account, koppel je horloge zodat je activiteiten binnenkomen, en voeg OpenAthlete daarna toe als connector.

Voor altijd gratis. Geen creditcard.