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, die Registrierung von OAuth-Apps läuft aber noch manuell.

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.

Fragen oder Ideen?

Die Entwicklerplattform ist jung und wird von dem geprägt, was Leute damit bauen. Für die Registrierung von OAuth-Apps, Fragen oder Feature-Wünsche schreib an developers@gravl.ai.