strava-mcp

MCP server for the Strava API v3. Exposes Strava data — activities, segments, routes, clubs, gear, and streams — as tools that any MCP client (Claude Desktop, Claude Code, etc.) can call.

Read-only by default. Pass --write to enable mutating tools (create/update activities, star segments).

OpenClaw-specific onboarding and sidecar setup: OPENCLAW.md.

Getting started

1. Create a Strava API application

Go to https://www.strava.com/settings/api and create an application. Note your Client ID and Client Secret.

2. Set up credentials

cp .env.example .env

Add your STRAVA_CLIENT_ID and STRAVA_CLIENT_SECRET to .env.

3. Build

pnpm install
pnpm build

4. Authenticate

pnpm auth

This opens your browser to authorize with Strava. After you approve, it automatically exchanges the code for tokens and saves STRAVA_ACCESS_TOKEN and STRAVA_REFRESH_TOKEN to your .env file. All scopes are requested (read_all, profile:read_all, activity:read_all, activity:write).

5. Test locally

pnpm inspect

Opens the MCP Inspector web UI where you can browse tools and call them interactively. Credentials are loaded from .env automatically.

You can also run the server directly:

pnpm start

6. Configure your MCP client

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "strava": {
      "command": "node",
      "args": ["/absolute/path/to/strava-mcp/build/index.js"],
      "env": {
        "STRAVA_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

To enable write tools (create/update activities, star segments), add "--write" to args:

{
  "mcpServers": {
    "strava": {
      "command": "node",
      "args": ["/absolute/path/to/strava-mcp/build/index.js", "--write"],
      "env": {
        "STRAVA_ACCESS_TOKEN": "your-access-token"
      }
    }
  }
}

Claude Code

claude mcp add strava node /absolute/path/to/strava-mcp/build/index.js

Automatic token refresh

Strava access tokens expire. To enable automatic refresh, provide all four env vars:

{
  "env": {
    "STRAVA_ACCESS_TOKEN": "your-access-token",
    "STRAVA_REFRESH_TOKEN": "your-refresh-token",
    "STRAVA_CLIENT_ID": "your-client-id",
    "STRAVA_CLIENT_SECRET": "your-client-secret"
  }
}

When a request returns 401 and refresh credentials are available, the server will automatically request a new access token from Strava's OAuth endpoint and retry the request.

Environment variables

Variable	Required	Description
STRAVA_ACCESS_TOKEN	Yes	Strava OAuth2 bearer token
STRAVA_REFRESH_TOKEN	No	Enables automatic token refresh on 401
STRAVA_CLIENT_ID	No	Required alongside refresh token
STRAVA_CLIENT_SECRET	No	Required alongside refresh token

Tools

Read tools (always available)

Athlete

Tool	Description
get_athlete	Get the authenticated athlete's profile
get_athlete_stats	Get athlete stats (totals, recent, YTD, all-time)
get_athlete_zones	Get heart rate and power zones

Activities

Tool	Description
list_activities	List the athlete's activities (filterable by before/after timestamps)
get_activity	Get full details of a specific activity
list_activity_comments	List comments on an activity
list_activity_kudoers	List athletes who kudoed an activity
list_activity_laps	List laps of an activity
get_activity_zones	Get heart rate/power zones for an activity
get_activity_streams	Get time-series data (heartrate, power, cadence, GPS, etc.)

Segments

Tool	Description
get_segment	Get details of a specific segment
explore_segments	Find popular segments within a bounding box
list_starred_segments	List the athlete's starred segments
get_segment_effort	Get details of a segment effort
list_segment_efforts	List efforts on a segment, optionally filtered by date
get_segment_streams	Get data streams for a segment
get_segment_effort_streams	Get data streams for a segment effort

Routes

Tool	Description
get_route	Get details of a specific route
list_athlete_routes	List routes created by an athlete
get_route_streams	Get data streams for a route

Clubs

Tool	Description
get_club	Get details of a specific club
list_athlete_clubs	List the athlete's clubs
list_club_members	List members of a club
list_club_activities	List recent activities in a club

Gear

Tool	Description
get_gear	Get details of a piece of equipment

Write tools (requires --write flag)

Tool	Description
create_activity	Create a manual activity
update_activity	Update an existing activity (name, description, sport type, gear, etc.)
star_segment	Star or unstar a segment

Documentation

• Use cases — example prompts and what you can do with the server
• Architecture — file structure, data flow, and component responsibilities
• Design decisions — rationale behind the read/write split, token refresh strategy, thin client approach, and other trade-offs