Strava MCP Server

An MCP (Model Context Protocol) server that provides tools for interacting with the Strava API v3. Built with TypeScript and the MCP SDK.

Tools

Activities

strava_list_activities - List the authenticated athlete's activities with date range filtering and pagination
strava_get_activity - Get detailed activity info including splits, laps, segment efforts, and gear
strava_create_activity - Create a manual activity entry
strava_update_activity - Update an activity's mutable properties
strava_list_activity_comments - List comments on an activity
strava_list_activity_kudoers - List athletes who gave kudos
strava_list_activity_laps - List laps with distance, time, speed, heart rate, watts, and elevation
strava_list_activity_zones - Get heart rate and power zone distribution

Athletes

strava_get_authenticated_athlete - Get the authenticated athlete's profile
strava_get_athlete_zones - Get heart rate and power zones
strava_get_athlete_stats - Get year-to-date and all-time totals for runs, rides, and swims

Segments

strava_get_segment - Get segment details including distance, elevation, grade, and effort count
strava_list_segment_efforts - List efforts on a segment with date range filtering
strava_get_segment_effort - Get a specific segment effort with achievements
strava_explore_segments - Find popular segments within a geographic bounding box
strava_star_segment - Star or unstar a segment

Routes

strava_list_athlete_routes - List routes created by an athlete
strava_get_route - Get detailed route information
strava_export_route_gpx - Export a route as GPX
strava_export_route_tcx - Export a route as TCX

Streams (Time-Series Data)

strava_get_activity_streams - Get activity streams (heart rate, power, cadence, altitude, GPS, etc.)
strava_get_segment_effort_streams - Get segment effort streams
strava_get_segment_streams - Get segment GPS/altitude data
strava_get_route_streams - Get route GPS/altitude data

Clubs

strava_list_athlete_clubs - List clubs the athlete belongs to
strava_get_club - Get club details
strava_list_club_activities - List recent club member activities
strava_list_club_members - List club members
strava_list_club_admins - List club admins

Gear

strava_get_gear - Get equipment details (bikes, shoes)

Uploads

strava_create_upload - Upload a FIT/TCX/GPX file to create an activity
strava_get_upload - Check upload processing status

Setup

1. Create a Strava API Application

Go to Strava API Settings and create an application. Note your Client ID and Client Secret.

2. Get an Access Token

You need an access token with the appropriate scopes. For read-only access use read,activity:read_all. For write access add activity:write.

You can obtain tokens through Strava's OAuth flow. The server will automatically refresh expired tokens if STRAVA_REFRESH_TOKEN, STRAVA_CLIENT_ID, and STRAVA_CLIENT_SECRET are set.

3. Configure Environment Variables

export STRAVA_CLIENT_ID="your_client_id"
export STRAVA_CLIENT_SECRET="your_client_secret"
export STRAVA_ACCESS_TOKEN="your_access_token"
export STRAVA_REFRESH_TOKEN="your_refresh_token"

4. Add to Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "strava": {
      "command": "npx",
      "args": ["-y", "strava-mcp-server"],
      "env": {
        "STRAVA_CLIENT_ID": "your_client_id",
        "STRAVA_CLIENT_SECRET": "your_client_secret",
        "STRAVA_ACCESS_TOKEN": "your_access_token",
        "STRAVA_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Or if installed locally:

{
  "mcpServers": {
    "strava": {
      "command": "node",
      "args": ["/path/to/strava-mcp/dist/index.js"],
      "env": {
        "STRAVA_CLIENT_ID": "your_client_id",
        "STRAVA_CLIENT_SECRET": "your_client_secret",
        "STRAVA_ACCESS_TOKEN": "your_access_token",
        "STRAVA_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Development

npm install
npm run build
npm run dev    # watch mode with tsx

License

MIT

Strava MCP Server