← Back to all apps

Overview

Tools Available4
CategoryLifestyle

Discover Peloton workouts

Available Tools

Peloton provides 4 tools that can be used to interact with its services.

Create Interactive Training Plan

create-training-plan
Full Description

Create interactive weekly training plan (max 14 days) with drag-and-drop class cards and rest days. Shows calendar with day labels, class details, and "Add to calendar" button.

MUST call search first to get class indices. Use index from search results for workout days. For rest days: set isRestDay=true, omit index. Each day needs ISO date (YYYY-MM-DD).

Invalid indices become rest days. Never construct or guess index numbers.

Parameters

Required
planarray

Days in chronological order (max 14). Workout days need index from search. Rest days need isRestDay=true, no index.

Optional
localestring

Locale for class details

Default: en-US
titlestring

Training plan title

Peloton Class Details

fetch
Full Description

Get detailed view of a specific Peloton class by index. Shows hero image, instructor, description, equipment, ratings, and link to Peloton.

Requires class index from search results. Use search first if you don't have an index.

Parameters

Required
indexinteger

Class index from search results. Each class in the search results has an index, use this to fetch the details for that class.

Optional
localestring

Locale (BCP 47 format)

Default: en-US

Schedule Classes to Calendar

schedule
Full Description

Add classes to user's Peloton calendar. Requires authentication. Shows confirmation widget with link to https://members.onepeloton.com/yourschedule where users can view their scheduled classes.

Input: Array of {index: class index from search, startTime: ISO 8601 datetime}. Processes multiple classes in parallel. Returns success/failure for each.

Use create-training-plan first if user wants to visualize/plan before scheduling.

Parameters

Required
classesarray

Array of classes to schedule

Peloton Class Search

search
Full Description

Search 60,000+ Peloton classes using natural language. Returns interactive carousel with class cards.

Supports single queries ("30 min yoga with Emma") or multiple comma-separated queries ("marathon, meditation, recovery yoga", max 3). Advanced features: instructor matching (45+ instructors), music artist search (200+ artists like "Green Day", "Beyoncé"), difficulty filtering (beginner/intermediate/advanced or 1-10), duration matching (exact minutes), discipline filtering (cycling, strength, yoga, running, walking), year filtering ("2025 running", "2024 yoga"). Searches all disciplines when none specified. Only returns English-language classes.

IMPORTANT

  • Seasonal/Holiday Queries: When users search for seasonal terms (fall, spring, summer, winter) or holidays (Halloween, Christmas, Thanksgiving, New Year, Valentine's Day), convert them to specific years in your query. Examples: "fall cycling" → "2024 cycling", "halloween yoga" → "2024 yoga", "christmas rides" → "2024 cycling". Use current year or previous year based on context.

Each result includes an "index" field (0-60000) - use this index with fetch and create-training-plan tools. Never use slugs or construct index numbers.

After search, recommend create-training-plan to organize classes into a weekly schedule.

Parameters

Required
querystring

Natural language search query. Single query ("30 min yoga") or comma-separated (max 3): "cycling, yoga, strength". Recognizes: instructors, genres, durations, class types, difficulty, year (e.g., "2024 cycling"). For seasonal/holiday terms (fall, halloween, christmas, etc.), convert to year-based queries (e.g., "fall rides" → "2024 cycling"). English classes only.

Optional
limitPerQueryinteger

Max results per query (default: 10, max: 15)

Default: 10