strava

Category: Data & AI | Uploader: eddmann | Downloads: 0 | Version: v1.0（Latest）

Query Strava fitness data including activities, athlete stats, segments, routes, clubs, and gear. Use when the user asks about cycling, running, swimming, workouts, training, or Strava data.

Changelog: Source: GitHub https://github.com/eddmann/strava-cli

Directory Structure

Current level: tree/main/

📁 .github/
- 📁 workflows/
  - 📄 deploy-pages.yml 1.6 KB
  - 📄 release.yml 4.7 KB
  - 📄 test.yml 913 B
📁 docs/
- 📄 heading.png 1.7 MB
📁 site/
- 📄 index.html 40.5 KB
- 📄 logo.png 41.8 KB
- 📄 preview.png 1.7 MB
📁 src/
- 📁 strava_cli/
  - 📁 commands/
    
    📄 __init__.py 38 B
    
    📄 activities.py 7.8 KB
    
    📄 athlete.py 1.5 KB
    
    📄 auth.py 5.0 KB
    
    📄 clubs.py 1.6 KB
    
    📄 context.py 6.1 KB
    
    📄 efforts.py 1.3 KB
    
    📄 gear.py 588 B
    
    📄 routes.py 3.0 KB
    
    📄 segments.py 2.7 KB
    
    📄 upload.py 4.8 KB
  - 📄 __init__.py 101 B
  - 📄 __main__.py 117 B
  - 📄 auth.py 8.7 KB
  - 📄 cli.py 4.3 KB
  - 📄 client.py 12.9 KB
  - 📄 config.py 8.0 KB
  - 📄 decorators.py 7.3 KB
  - 📄 exceptions.py 3.5 KB
  - 📄 output.py 9.7 KB
📁 tests/
- 📄 __init__.py 28 B
- 📄 conftest.py 7.3 KB
- 📄 test_cli.py 23.0 KB
📄 .gitignore 264 B
📄 .python-version 5 B
📄 AGENTS.md 392 B
📄 CHANGELOG.md 1.4 KB
📄 CLAUDE.md 9 B
📄 install-skill.sh 950 B
📄 install.sh 1.8 KB
📄 LICENSE 1.0 KB
📄 Makefile 2.8 KB
📄 pyproject.toml 1.7 KB
📄 README.md 8.9 KB
📄 SKILL.md 2.9 KB
📄 uv.lock 126.3 KB

SKILL.md

---
name: strava
description: Query Strava fitness data including activities, athlete stats, segments, routes, clubs, and gear. Use when the user asks about cycling, running, swimming, workouts, training, or Strava data.
---

# Strava CLI Skill

Query and manage Strava data via the `strava` CLI.

## Prerequisites

- Install CLI: `curl -fsSL https://raw.githubusercontent.com/eddmann/strava-cli/main/install.sh | sh`
- Authenticate: `strava auth login` (requires `STRAVA_CLIENT_ID`, `STRAVA_CLIENT_SECRET`)

## Quick Context

Get aggregated athlete data in one call:

```bash
strava context                          # Full context: athlete, stats, gear, clubs, activities
strava context --activities 10          # More recent activities
strava context --focus stats,gear       # Specific sections only
```

## Commands

Run `strava --help` or `strava <command> --help` to discover all options.

### Activities

```bash
strava activities list [--after DATE] [--before DATE] [--limit N]
strava activities get <ID>
strava activities streams <ID> [--keys time,distance,heartrate,watts]
strava activities laps <ID>
strava activities zones <ID>
strava activities comments <ID>
strava activities kudos <ID>
```

### Athlete

```bash
strava athlete              # Profile
strava athlete stats        # YTD and all-time totals
strava athlete zones        # HR/power zones
```

### Segments & Efforts

```bash
strava segments get <ID>
strava segments starred
strava segments explore --bounds SW_LAT,SW_LNG,NE_LAT,NE_LNG
strava efforts get <ID>
strava efforts list --segment-id <ID>
```

### Routes, Clubs, Gear

```bash
strava routes list
strava routes get <ID>
strava routes streams <ID>
strava routes export <ID> --format gpx|tcx
strava clubs list
strava clubs get <ID>
strava clubs members <ID> [--limit N]
strava clubs activities <ID> [--limit N]
strava gear get <GEAR_ID>
```

## Data Units

| Field                     | Unit    |
| ------------------------- | ------- |
| distance                  | meters  |
| moving_time, elapsed_time | seconds |
| average_speed, max_speed  | m/s     |
| elevation                 | meters  |
| dates                     | ISO8601 |

## Common Patterns

```bash
# Recent activities
strava activities list --limit 10

# This month's activities
strava activities list --after 2025-12-01

# Filter with jq
strava activities list | jq '[.[] | select(.sport_type=="Run")]'

# Total distance
strava activities list | jq '[.[].distance] | add'
```

## Auth Status

```bash
strava auth status    # Check if authenticated
strava auth refresh   # Refresh token
strava auth logout    # Clear credentials
```

## Sport Types

Run, TrailRun, Walk, Hike, Ride, MountainBikeRide, GravelRide, EBikeRide, VirtualRide, VirtualRun, Swim, Workout, WeightTraining, Yoga, CrossFit, Rowing, Kayaking, Surf, Ski, Snowboard, IceSkate, Golf, Soccer, Tennis

## Exit Codes

- 0 = Success
- 1 = General error
- 2 = Auth error (run `strava auth login`)

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

strava

Directory Structure

SKILL.md

Report

Notice