strava-api

What problem does it solve?

Provides a secure, developer-friendly way to access and manage Strava fitness data while preventing secret exposure to AI agents or logs. It centralizes OAuth setup, token refresh, and API calls so users and scripts can retrieve athlete profiles, activities, segments, routes, and related training data without manual token juggling.

Core Features & Use Cases

• Interactive OAuth Setup: Guided flow to create a Strava application, obtain an authorization code, and exchange it for tokens.
• Secure Credential Handling: Stores client credentials and tokens in the system keychain or Linux secret service so secrets are not exposed to AI or logs.
• Automatic Token Management: Refreshes access tokens transparently and persists non-secret metadata locally.
• CLI and Python Client: Ready-to-use CLI commands and a StravaClient class to get athlete profiles, list and create activities, explore segments, export routes, and fetch activity streams.
• Use Case: Validate configuration, fetch your athlete profile, list recent activities, and export a route as GPX for external analysis.

Quick Start

Get my athlete profile and list my 20 most recent activities to verify Strava is configured and returning data.