Concept2-logbook

Data & APIs

Fetch and analyze Concept2 Logbook workout data via API with pulse zone analysis and trend tracking. Use when the user wants to retrieve rowing/skiing/biking workouts, analyze heart rate zones, track training trends over time, get workout summaries with performance insights, or evaluate training effectiveness. Features include pulse zone distribution (5-zone model), weekly trend analysis, pace consistency evaluation, improvement tracking, and personalized training recommendations. Requires Concept2 API access token.

Install

openclaw skills install concept2

Concept2 Logbook API Skill

Fetch and analyze workout data from Concept2 Logbook with advanced pulse zone and trend analysis.

Quick Start

Use the provided script to fetch workouts:

python3 scripts/fetch_workouts.py --token <API_TOKEN> --from-date 2026-03-01 --format table

API Authentication

Requires a Concept2 API access token. Get one from: https://log.concept2.com/developers/keys

Token must be passed with Authorization: Bearer <token> header.

Main Endpoints

Endpoint	Description
`GET /api/users/me`	Get authenticated user info
`GET /api/users/me/results`	Get workouts (paginated)
`GET /api/users/me/results/{id}`	Get specific workout
`GET /api/users/me/results/{id}/strokes`	Get stroke-level data

Query Parameters for Results

Param	Type	Description
`from`	date	Start date (YYYY-MM-DD)
`to`	date	End date (YYYY-MM-DD)
`type`	string	Workout type: rower, skierg, bike, etc.
`per_page`	integer	Results per page (max 250)

Workout Types

Type	Description
JustRow	Free rowing
FixedDistanceSplits	Fixed distance with splits
FixedTimeSplits	Fixed time with splits
FixedCalorie	Fixed calorie target
FixedWattMinute	Fixed watt-minute target
FixedTimeInterval	Time-based intervals
FixedDistanceInterval	Distance-based intervals
FixedCalorieInterval	Calorie intervals
FixedWattMinuteInterval	Watt-minute intervals
VariableInterval	Variable intervals
VariableIntervalUndefinedRest	Variable with undefined rest

Equipment Types

Type	Description
rower	RowErg
skierg	SkiErg
bike	BikeErg
dynamic	Dynamic RowErg
slides	RowErg with slides
paddle	PaddleErg
water	WaterRower
snow	Snow (Nordic skiing)
rollerski	Roller skiing
multierg	MultiErg

Script Usage

Basic Usage - Summary with Pulse Zones

# Auto-detect max HR from birthdate in profile
python3 scripts/fetch_workouts.py --token <TOKEN> --from-date 2026-03-01

# Specify max HR manually
python3 scripts/fetch_workouts.py --token <TOKEN> --max-hr 165 --from-date 2026-02-01

# Estimate max HR from age
python3 scripts/fetch_workouts.py --token <TOKEN> --age 59 --from-date 2026-02-01

Trend Analysis (8 weeks)

python3 scripts/fetch_workouts.py --token <TOKEN> --trends 8 --from-date 2026-01-01

Other Formats

# Simple table
python3 scripts/fetch_workouts.py --token <TOKEN> --format table

# JSON export
python3 scripts/fetch_workouts.py --token <TOKEN> --format json > workouts.json

# Filter by equipment type
python3 scripts/fetch_workouts.py --token <TOKEN> --type skierg

Pulse Zone Analysis (5-Zone Model)

Zones based on percentage of maximum HR:

Zone	Name	Range	Purpose
🟢 1	Restitusjon	0-60%	Recovery, warmup
🔵 2	Aerob kapasitet	60-70%	Base building
🟡 3	Aerob effekt	70-80%	Tempo training
🟠 4	Anaerob terskel	80-90%	Threshold/intervals
🔴 5	Maks kapasitet	90-100%	VO2max/sprints

Max HR Calculation

Manual: --max-hr 165
From age: --age 59 (uses Tanaka formula: 208 - 0.7×age)
From profile: reads birthdate from user data

Trend Analysis

Weekly aggregation of:

Total distance
Total time
Number of workouts
Average pace
Improvement rate (pace change %)

Workout Quality Metrics

Pace Consistency

Calculated from split data if available
Standard deviation / average pace
Rating: 🟢 Jevn | 🟡 OK | 🔴 Ujevn

Stroke Rate (SPM) Assessment

🟢 18-22: Efficient, strong drive
🔵 <18: Fast recovery phase
🟡 24-28: Tempo pace
🟠 >30: High rate, check technique

Training Recommendations

The script provides personalized tips:

Training frequency assessment
High intensity balance (20% rule for zones 4-5)
Long workout suggestions
Interval training reminders

Common Calculations

Calculate Pace

pace_tenths = (time_tenths / distance_m) * 500

Format Time

total_seconds = time_tenths / 10
minutes = int(total_seconds // 60)
seconds = total_seconds % 60
formatted = f"{minutes}:{seconds:04.1f}"

Distance Format

Stored in meters
5000 = 5km

Stroke Data

Distance in decimeters (incremental)
Time in tenths of seconds (incremental)
Pace in tenths of sec per 500m (rower) or 1000m (bike)

Error Codes

Code	Meaning	Resolution
200	OK	Success
201	Created	Resource created successfully
400	Bad Request	Check request format
401	Unauthorized	Invalid or expired token
403	Forbidden	User hasn't authorized app
404	Not Found	Resource doesn't exist
409	Conflict	Duplicate entry
422	Unprocessable	Validation error
500	Server Error	Try again later
503	Service Unavailable	API temporarily down

Pagination

Paginated responses include a meta.pagination object:

{
  "meta": {
    "pagination": {
      "total": 150,
      "count": 50,
      "per_page": 50,
      "current_page": 1,
      "total_pages": 3,
      "links": {
        "next": "https://log.concept2.com/api/users/me/results?page=2"
      }
    }
  }
}

Default per_page is 50, maximum is 250.