Erste Schritte

Baue auf Gravl.

Deine Trainingsdaten, programmierbar. Eine versionierte, Read-only-REST-API mit Scopes über Workouts, Rekorde, Messungen und Stats, plus ein MCP-Server, mit dem KI-Assistenten auf deinem Gravl-Account arbeiten können.

Persönliche Tokens

Du baust etwas für dich selbst? Erstelle ein Token in deinem eigenen Account und lies deine Daten mit einem einzigen Request.

OAuth-Apps

Du baust für andere Gravl-Nutzer? Fordere Zugriff per OAuth 2.0 an: Nutzer gewähren nur die Scopes, die du anfragst.

Gravl MCP

Verbinde Claude oder einen beliebigen MCP-Client mit deinem Account: logge Workouts und steuere dein Training aus einer Unterhaltung.

Die API auf einen Blick

Base URL	`https://api.gravl.ai`
Version	Alle Endpoints liegen unter `/api/v1`; Breaking Changes erscheinen ausschließlich als neue Version.
Format	JSON rein und raus; UTF-8; Datumsangaben sind UTC im ISO-8601-Format.
Auth	Bearer Tokens (`gat_…`) aus einem persönlichen Token oder einem OAuth-Grant.
Zugriff	Aktuell Read-only. Write-Scopes kommen bewusst und explizit, nie implizit.
CORS	Offen (ohne Credentials) auf `/api/v1` und `/oauth`; Browser-Apps können die API direkt aufrufen.
Status	Beta: die API-Oberfläche ist stabil. OAuth-Apps registrierst du selbst in deinen Account-Einstellungen; nach einer Prüfung stehen sie allen Gravl-Nutzern offen.

Dein erster Request

Hol dir ein persönliches Token und du bist nur noch einen curl-Befehl von deinem Trainingsverlauf entfernt:

Deine Workouts auflisten

curl "https://api.gravl.ai/api/v1/workouts?page=1&pageSize=2" \
  -H "Authorization: Bearer gat_…"

{
  "items": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "name": "Push Day",
      "notes": null,
      "startDate": "2026-07-12T17:03:00Z",
      "endDate": "2026-07-12T18:05:00Z",
      "durationMinutes": 62,
      "type": "custom",
      "volume": 24150,
      "calories": 410,
      "personalRecordCount": 1,
      "exerciseCount": 6
    }
  ],
  "pageNumber": 1,
  "totalPages": 87,
  "totalCount": 174,
  "hasPreviousPage": false,
  "hasNextPage": true
}

Jedes Token, ob persönlich oder per OAuth, ist an genau einen Nutzer und einen Satz Scopes gebunden. Es gibt keinen Scope, der Zugriff auf die Daten anderer Nutzer gewährt.