Intervals.icu API Management for Openclaw

A comprehensive integration for managing athlete profiles, training activities, calendar events, and wellness data via the Intervals.icu API.

pseuss
v2.0.1
Jan 27, 2026
1
2.9k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install intervals-icu-api

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install intervals-icu-api using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Intervals.icu API Management?

This skill provides a robust framework for interacting with the Intervals.icu platform, designed for developers and AI agents to manage endurance training data. By utilizing Openclaw Skills, you can programmatically access athlete metrics, synchronize completed activities, and schedule planned workouts. It simplifies complex performance analysis by offering structured access to power zones, heart rate data, and training load metrics.

Whether you are building a coaching dashboard or a personal fitness tracker, this skill bridges the gap between raw training files and actionable insights. It covers everything from basic authentication to advanced data stream exports, ensuring that your AI agent can handle the full lifecycle of athlete data management efficiently.

Intervals.icu API Management Use Cases

  • Synchronizing training activities between Intervals.icu and external data warehouses.
  • Automating the generation and uploading of weekly structured training plans.
  • Tracking athlete wellness trends including HRV, sleep duration, and fatigue levels.
  • Exporting high-resolution activity streams for custom performance modeling and analysis.
  • Programmatically updating physiological settings like FTP and heart rate zones based on recent performance.

How Intervals.icu API Management Works

  1. Authentication is established using an Athlete ID combined with either an API Key or a Bearer Token.
  2. The skill queries the base API endpoint to retrieve specific athlete profile information.
  3. Activity and event data are filtered using date ranges and specific field selectors to optimize performance.
  4. New activities or calendar events are created or updated using JSON payloads, often employing bulk operations for efficiency.
  5. Wellness records and sport-specific settings are synchronized to maintain an accurate physiological profile of the athlete.

Intervals.icu API Management Setup

To get started, retrieve your Athlete ID and API Key from your Intervals.icu settings page. Ensure all requests use the base URL https://intervals.icu/api/v1 and follow the ISO-8601 date format. You can verify your setup with a simple curl command:

# Replace YOUR_API_KEY and YOUR_ATHLETE_ID with your credentials
curl -H "Authorization: ApiKey API_KEY:YOUR_API_KEY" \
  https://intervals.icu/api/v1/athlete/YOUR_ATHLETE_ID

Intervals.icu API Management Data Schema & Taxonomy

The skill organizes training data into distinct entities to facilitate clean integration. Below are the primary data structures managed by Openclaw Skills:

Entity Data Type Purpose
Activities JSON/CSV Completed training sessions including GPS, power, and HR data.
Events JSON Planned workouts, notes, or training targets on the calendar.
Wellness JSON Daily health metrics such as sleep, resting HR, and soreness.
Sport Settings JSON Configuration for sport-specific zones (Power, HR, Pace) and FTP.
Streams CSV/JSON Raw time-series data for watts, heart rate, and cadence.

Intervals.icu API Management Advanced Features

  • Smart field selection to minimize bandwidth and processing time by requesting only necessary data points.
  • Bulk upsert capabilities for calendar events using the upsertOnUid parameter to prevent duplicate entries.
  • Multi-format workout exports supporting .fit, .zwo, .mrc, and .erg files for device compatibility.
  • Automated recalculation of heart rate zones when updating Lactate Threshold (LTHR).
  • External ID mapping to maintain consistency when syncing with third-party platforms like Strava.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*