API for developers and AI agents

An easy access to read and push
training data in Nolio.
Data flows bidirectionally between your app, the Nolio API and Nolio.

Access the API portal

Go to the API portal

What you can do

Workouts

  • Read, create, update and delete trainings
  • Read, create, update and delete competitions
  • Read training data

User

  • Read user info
  • Access their athletes

Metrics

  • Read, and update metrics : HRV, VO2, FTP, PMA, FCMax, weight...

Personal bests

  • Read records

Notes

  • Read notes

Files

  • Upload a file
See API documentation

Live events with webhooks

Developers get webhooks to access planned and completed workouts, metrics and more.

Nolio API provides the tools to build
with Claude, Gemini or ChatGPT.

You are the Nolio API onboarding assistant. You guide coaches (or their devs) in connecting their tool to the Nolio ecosystem. Answer briefly, give ready-to-paste code, in the user's language (EN by default).
# Response rules
- Always HTTPS. Never a `client_secret` on the front end, public mobile, or browser JS.
- If the user asks for an endpoint or field not listed here, DO NOT INVENT IT: refer them to the documentation (https://github.com/NolioApp/NolioAPI-Documentation/).
- Always recommend a trailing `/` on endpoints (always valid; some POSTs accept it without, but better to stay consistent).
- No public sandbox environment: use a dedicated test account on prod.
- No URL versioning (no `v1/v2`). Changes are announced on the wiki — always point to the up-to-date docs.
# Getting started
- Auth: OAuth2 authorization-code. Create your app in the API portal to get your client_id / client_secret, then exchange the authorization code at POST /api/token/.
- Full reference (endpoints, fields, scopes, examples): https://github.com/NolioApp/NolioAPI-Documentation/

Safety first

Access to the API is protected by the OAuth protocol.

The OAuth protocol identifies the app and the user account accessing the data. All requests to the API require a valid OAuth token.

See OAuth documentation

Integrate the Nolio brand

Logos, colors, mockups, all the assets you need.
See Media Kit

Nolio MCP

The easiest way for your agent to communicate with Nolio.
Connect my AI assistant

Use Nolio with Claude or ChatGPT

Requirements

  • A paid Nolio account: a coach or Premium Athlete subscription.
  • Claude, on claude.ai, or ChatGPT, on chatgpt.com.

Connect with Claude

  1. In Claude, open Settings > Connectors.
  2. Add Nolio from the connectors directory, or create a custom connector with this address: https://mcp.nolio.io/mcp
  3. Log in with your Nolio account and choose the permissions granted to Claude: read, create, update, delete.

Connect with ChatGPT

  1. In ChatGPT, open Plugins in the sidebar.
  2. Add Nolio from the plugin directory.
  3. Log in with your Nolio account and choose the permissions granted to ChatGPT: read, create, update, delete.

Examples

  • Show me my training calendar for the week.
  • What workouts did Léa do over the last 7 days, compared to what was planned?
  • How have Paul's HRV and sleep evolved over the last two weeks?
  • Add a run for Léa on Thursday: 15 min warm-up, 6 × 800 m in zone 5 with 2 min recovery in zone 1, then 10 min cooldown.
  • Plan the Paris Marathon as Léa's main goal, with a two-week taper cycle before it.
  • Apply my “Long run Z2” template to the whole Marathon group next Sunday.

How it works

  • A creation or a deletion can be undone. A change cannot.
  • A coach only has access to the athletes they coach. A team can restrict what its coaches can do from its options.
  • Data from some connected services is not passed on to AI assistants, in line with the terms of those services.

Troubleshooting

  • If your assistant reports a missing permission, reconnect Nolio and tick the requested permission.
  • To remove access: Settings > MCP in Nolio, Settings > Connectors in Claude, or Plugins in ChatGPT.
  • Contact: contact@nolio.io · Privacy policy