Peloton

Purpose

Connect to Peloton to browse on-demand and live fitness classes, manage schedules, and book workouts.

Tooling

Use the installed CLI directly from PATH.

Core auth commands:

• peloton status
• peloton authorize-url
• peloton disconnect

Class Browsing

• peloton ride-archived [--limit 10] [--page 0] [--fitness-discipline cycling] [--duration 1800] [--sort-by popularity] [--difficulty-level beginner] [--has-closed-captions true] [--super-genre-id <ID>] [--browse-category cycling] [--class-type-id <ID>] [--instructor <ID>] [--desc true]
• peloton ride-live [--limit 10] [--schedule-type live] [--exclude-complete true] [--days 7] [--fitness-discipline cycling] [--super-genre-id <ID>] [--browse-category cycling] [--class-type-id <ID>] [--instructor <ID>] [--desc true]
• peloton search-class --query "<text>" --limit 10 --page 0 [--include-raw] [--include-schema] — search classes by natural-language or partner-provided terms such as "seated strength". Always pass --limit and --page; use --limit 10 --page 0 unless the user asks for a different local result window. Use --include-raw or --include-schema only when inspecting the response shape.

Response structure: class browsing commands return a presentation-ready body.classes[] array. search-class also returns local-window fields: body.count, body.total, body.page, body.limit, body.has_more, and body.pagination_mode: "local_window". Peloton search does not support API pagination; --limit and --page only slice the returned result set locally. For different results, refine the query instead of trying to fetch another provider page. Raw provider arrays may be present only for debug commands that request them.