Intervals Cli

Intervals CLI Skill

This skill helps you use the intervals CLI tool to interact with the intervals.icu API.

Prerequisites

• The intervals binary must be built or available in PATH
• INTERVALS_API_KEY environment variable must be set
• The user's athlete ID — check AGENTS.md in the repo root, or ask the user

Command Reference

All commands output JSON by default.

Athlete & Profile

| Command | Description | |---------|-------------| | intervals get-athlete | Get basic athlete profile | | intervals get-athlete-profile | Get detailed athlete profile (city, country, timezone, sex) | | intervals get-athlete-summary [--start ] [--end ] | Get athlete summary (fitness data, CTL/ATL, training load) | | intervals get-athlete-settings | Get settings for phone/tablet/desktop | | intervals get-athlete-training-plan | Get current training plan | | intervals update-training-plan --data | Update athlete training plan | | intervals update-athlete-plans --data | Update training plans for multiple athletes | | intervals apply-plan-changes | Apply plan changes to calendar | | intervals get-athlete-mmp-model | Get MMP power model for a sport | | intervals list-sport-settings | Get sport settings (FTP, LTHR per sport) | | intervals get-sport-setting | Get sport setting by ID | | intervals create-sport-setting | Create sport setting (options: --types, --ftp, --lthr, --name) | | intervals update-sport-setting | Update sport setting (options: --types, --ftp, --lthr, --name) | | intervals delete-sport-setting | Delete sport setting | | intervals apply-sport-setting | Apply setting to matching activities | | intervals list-sport-setting-matching | List activities matching setting | | intervals list-sport-setting-pace-distances | List pace distances for sport | | intervals list-gear | List athlete gear (bikes, shoes, etc.) | | intervals get-gear | Get a specific gear item | | intervals create-gear | Create new gear (options: --name, --distance, --retired) | | intervals update-gear | Update gear (options: --name, --distance, --retired) | | intervals delete-gear | Delete gear | | intervals replace-gear | Retire and replace gear (options: --new-gear-id, --retired-date) | | intervals list-custom-items | List custom items (charts, custom fields) | | intervals get-custom-item | Get a specific custom item | | intervals delete-custom-item | Delete a custom item | | intervals create-custom-item --data | Create a custom item | | intervals update-custom-item --data | Update a custom item | | intervals update-custom-item-indexes --data | Re-order custom items | | intervals upload-custom-item-image | Upload image for custom item |

Activities

| Command | Description | |---------|-------------| | intervals list-activities --oldest | List activities (required: --oldest, optional: --newest, --limit, --route-id) | | intervals list-activities-around | List activities before/after another (options: --route-id, --limit) | | intervals get-activity | Get a single activity's details | | intervals get-activities | Fetch multiple activities by id (comma-separated, option: --intervals) | | intervals update-activity [options] | Update activity (options: --name, --description, --activity-type, --sport, --distance, --elapsed-time) | | intervals create-manual-activity --start-date-local --activity-type | Create manual activity (options: --name, --description, --sport, --distance, --elapsed-time) | | intervals delete-activity | Delete an activity | | intervals search-activities | Search activities by name or tag | | intervals search-activities-full | Search activities returning full details (option: --limit) | | intervals search-activity-intervals | Find activities with matching intervals (options: --min-secs, --max-secs, --min-intensity, --max-intensity, --interval-type) | | intervals list-activity-messages | List messages/comments on an activity | | intervals post-activity-message | Post a message/comment to an activity | | intervals list-activity-intervals | List auto-detected intervals within an activity | | intervals list-activity-tags | List all activity tags for an athlete | | intervals get-interval-stats | Get interval stats for a portion of an activity | | intervals get-activity-best-efforts | Find best efforts (options: --duration, --distance, --count) | | intervals get-activity-streams | Get time series data (options: --types, --include-defaults) | | intervals get-activity-map | Get activity map data (lat/lng, bounds) | | intervals get-activity-weather-summary | Get weather summary for an activity | | intervals get-activity-segments | Get activity segments | | intervals get-activity-hr-curve | Get activity heart rate curve | | intervals get-activity-hr-histogram | Get activity heart rate histogram | | intervals get-activity-hr-load-model | Get activity heart rate load model | | intervals get-activity-pace-curve | Get activity pace curve | | intervals get-activity-pace-histogram | Get activity pace histogram | | intervals get-activity-power-curves | Get activity power curves | | intervals get-activity-power-curve | Get activity power curve | | intervals get-activity-power-histogram | Get activity power histogram | | intervals get-activity-power-spike-model | Get activity power spike model | | intervals get-activity-power-vs-hr | Get activity power vs heart rate | | intervals get-activity-gap-histogram | Get activity gradient-adjusted pace histogram | | intervals get-activity-time-at-hr | Get activity time at heart rate | | intervals update-activity-intervals --intervals | Update intervals for an activity | | intervals update-activity-interval --data | Update/create an interval | | intervals split-activity-interval --interval-id | Split an interval | | intervals delete-activity-intervals --interval-ids | Delete intervals | | intervals update-activity-streams --data | Update streams from JSON | | intervals update-activity-streams-csv --csv-file | Update streams from CSV | | intervals download-activity-file | Download original activity file | | intervals download-activity-fit-file | Download FIT file (options: --power, --hr) | | intervals download-activity-gpx-file | Download GPX file (options: --power, --hr) | | intervals download-activities-csv | Download all activities as CSV | | intervals upload-activity | Upload activity file (fit/tcx/gpx/zip) | | intervals create-manual-activities-bulk --activities | Bulk create manual activities | | intervals download-activity-fit-files --output | Download all FIT files as zip | | intervals download-gear-csv | Download gear as CSV | | intervals download-events-csv | Download events as CSV | | intervals download-wellness-csv | Download wellness as CSV | | intervals list-activity-streams-ext | List activity streams |

Performance Curves

| Command | Description | |---------|-------------| | intervals list-athlete-power-curves | List power curves for a sport type (e.g., Ride, Run) | | intervals list-athlete-hr-curves | List heart rate curves | | intervals list-athlete-pace-curves | List pace curves | | intervals get-power-hr-curve --start --end | Get power vs heart rate curve | | intervals list-pace-distances | List pace curve distances | | intervals list-athlete-hr-curves-best | List best heart rate curves | | intervals list-athlete-power-curves-best | List best power curves | | intervals list-athlete-pace-curves-best | List best pace curves |

Wellness & Weather

| Command | Description | |---------|-------------| | intervals list-wellness | List wellness records (weight, resting HR, HRV, mood, CTL/ATL) | | intervals get-wellness | Get wellness record for a specific date | | intervals update-wellness | Update wellness record (options: --weight, --resting-hr, --hrv, --mood, --sleep) | | intervals update-wellness-bulk --records | Bulk update wellness records | | intervals upload-wellness-csv | Upload wellness records from CSV | | intervals get-weather-forecast | Get weather forecast for athlete's location | | intervals get-weather-config | Get weather forecast configuration | | intervals update-weather-config | Update weather forecast configuration (--forecasts ) |

Workouts, Events & Calendar

| Command | Description | |---------|-------------| | intervals list-workouts | List workouts in athlete's library | | intervals get-workout | Get a specific workout | | intervals create-workout | Create workout (options: --name, --workout-type, --folder-id) | | intervals update-workout | Update workout (options: --name, --description, --workout-type) | | intervals delete-workout | Delete a workout | | intervals create-workouts-bulk --workouts | Create multiple workouts | | intervals duplicate-workouts --workout-ids | Duplicate workouts | | intervals download-workouts-zip | Download workouts as zip (options: --oldest, --newest, --ext) | | intervals download-workout | Download a workout (option: --ext) | | intervals download-workout-ext | Download a workout without athlete context (option: --ext) | | intervals import-workout | Import workout from file | | intervals list-folders | List workout folders and plans | | intervals list-folder-shared-with | List athletes a folder is shared with | | intervals delete-folder | Delete a folder and all its workouts | | intervals create-folder | Create folder (options: --name, --description, --folder-type) | | intervals update-folder | Update folder (options: --name, --description, --folder-type) | | intervals update-folder-shared-with --athlete-ids | Update folder sharing | | intervals update-folder-workouts --workout-ids | Update plan workouts | | intervals list-events | List calendar events (options: --oldest, --newest, --category, --limit) | | intervals create-event --start-date-local --event-type --category | Create calendar event (options: --name, --description, --uid, --upsert-on-uid) | | intervals get-event | Get an event (planned workout, note, etc.) | | intervals update-event | Update an event (options: --name, --description, --notes) | | intervals delete-event | Delete an event from calendar | | intervals mark-event-done | Mark event as done (create manual activity from planned workout) | | intervals delete-events-range --start-date --end-date | Delete events in date range | | intervals update-events-range --start-date --end-date | Update events in date range (options: --name, --description, --category) | | intervals delete-events-bulk | Bulk delete events (options: --ids, --external-ids) | | intervals create-events-bulk --events | Create multiple events | | intervals duplicate-events --event-ids | Duplicate events (options: --num-copies, --weeks-between) | | intervals apply-plan-to-events --folder-id | Apply training plan to events | | intervals download-event-workout | Download event workout (option: --ext) | | intervals list-event-tags | List event tags for an athlete | | intervals list-workout-tags | List workout tags for an athlete |

Routes

| Command | Description | |---------|-------------| | intervals list-athlete-routes | List saved routes | | intervals get-route | Get a route (option: --include-path for GPS data) | | intervals update-route | Update a route (options: --name, --description, --commute) | | intervals compare-routes | Compare two routes for similarity |

Chats

| Command | Description | |---------|-------------| | intervals list-chats | List chats | | intervals get-chat | Get a chat by id | | intervals list-chat-messages | List messages for a chat (options: --before-id, --limit) | | intervals send-chat-message | Send a chat message (option: --chat-id) | | intervals update-chat-message | Update a chat message | | intervals delete-chat-message | Delete a chat message | | intervals mark-chat-messages-seen | Mark messages as seen |

Other

| Command | Description | |---------|-------------| | intervals disconnect-app | Disconnect the app from intervals.icu | | intervals get-shared-event | Get a shared event (e.g. race) | | intervals list-fitness-model-events | List events that influence fitness calculation |

Examples

List recent activities

intervals list-activities  --oldest 2024-01-01 --limit 10

Create a manual run

intervals create-manual-activity  \
  --start-date-local "2024-06-15T07:00:00" \
  --activity-type Run \
  --name "Morning Run" \
  --distance 5000 \
  --elapsed-time 1500

Get power curves for cycling

intervals list-athlete-power-curves  Ride

Update an activity name

intervals update-activity  --name "New Name"

Get activity heart rate streams

intervals get-activity-streams  --types heartrate,time

Download a FIT file

intervals download-activity-fit-file  activity.fit

Get fitness summary for a date range

intervals get-athlete-summary  --start 2024-01-01 --end 2024-01-31

List upcoming calendar events

intervals list-events  --oldest 2024-06-01 --newest 2024-06-30

Mark a planned workout as done

intervals mark-event-done  

Common Activity Types

• Ride, VirtualRide, MountainBikeRide, GravelRide
• Run, TrailRun, Walk, Hike
• Swim, OpenWaterSwim
• NordicSki, AlpineSki
• Workout (indoor trainer)

Tips

• Dates use ISO-8601 format (e.g., 2024-01-15 or 2024-01-15T07:00:00)
• Distances are in meters, times are in seconds
• The --oldest flag is required for list-activities
• Power curves require an activity type (Ride, Run, etc.)
• Use --upsert-on-uid with create-event to avoid duplicates when the event has a known --uid
• Activity streams support types: time, heartrate, watts, cadence, speed, distance, altitude, latlng, temperature
• get-activity-best-efforts stream can be watts, heartrate, speed, cadence

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: yosmoc
• Source: yosmoc/intervals
• License: MIT

Install and usage instructions live in the source repository linked above.