| name | stravacli |
| description | Use the stravacli terminal tool to access Strava data (athlete profile, activities, streams, routes, segments, clubs, gear, uploads) and perform limited write actions (activity update/upload). Trigger when the user asks for Strava metrics/history/exports or wants Strava automation via CLI. |
stravacli
Use stravacli for Strava operations from terminal.
Setup
- Ensure binary is available in PATH:
stravacli --version
- Authenticate before data commands:
- Local:
stravacli auth login
- Headless/VPS:
stravacli auth login --remote, then complete with stravacli auth login --auth-url '<callback-url>'
- Verify auth:
stravacli auth status
Read commands (preferred by default)
- Athlete profile:
stravacli athlete me --json
- Athlete stats:
stravacli athlete stats --json
- Athlete zones:
stravacli athlete zones --json
- List activities:
stravacli activities list --per-page 10 --json
- Activity details:
stravacli activities get <id> --json
- Activity laps:
stravacli activities laps <id> --json
- Activity streams:
stravacli activities streams <id> --json
- Routes list/get:
stravacli routes list --json / stravacli routes get <id> --json
- Export route file:
stravacli routes export <id> --format gpx --out ./route.gpx
- Segments/starred/explore:
stravacli segments starred --json, stravacli segments explore --bounds <swlat,swlng,nelat,nelng> --json
- Clubs:
stravacli clubs list --json
- Gear:
stravacli gear get <id> --json
- Upload status:
stravacli uploads get <uploadId> --json
Write commands (ask/confirm first)
- Update activity metadata:
stravacli activities update <id> --name 'New name' --description '...'
- Upload activity file:
stravacli activities upload --file ./run.fit --yes --json
Always confirm intent before write actions.
Output conventions
- Use
--json when results need parsing or reuse.
- Keep user summaries concise; include key metrics and IDs.
- If a command fails with auth errors, suggest
stravacli auth status then re-login.
