check-strava-connection
Check if Strava is connected and show the current connection status. Use this when the user asks about their connection status.
LABSCO SUMMARY
Training data you can ask questions about, instead of scrolling a feed for it.
The whole surface is scoped to the authenticated athlete, so this reads your own history rather than researching anyone else's. Authentication is handled in-band — connect-strava opens a browser, disconnect-strava removes the stored credentials — so there is no key to place in a config file before the first call. Route export is the one operation that writes to your machine, and it targets a directory that has to be configured beforehand.
What it is
A Strava client scoped to the authenticated athlete: activities and their raw streams, segments and efforts, routes, and the account connection itself.
What you get
- Activity history at three grains: the most recent, the complete history filtered by date range and activity or sport type, and one activity in full detail
- Time-series streams from an activity — heart rate, power, speed, GPS coordinates — at a density you choose from about 100 points to about 10,000, with pagination
- Lap-by-lap data for an activity, and the athlete's own configured heart-rate and power zones
- The athlete profile with the numeric id the stats tools need, and recent, year-to-date and all-time statistics for it
- Segments end to end: the ones you starred, a specific segment or effort, your efforts on a segment across a date window, and starring or unstarring
- Segment discovery inside a geographical bounding box, narrowed by activity type and climb category
- Routes you created, exported as GPX or TCX into a pre-configured local directory, plus the photos attached to an activity at a pixel size you name
Requirements
A Strava account you authorise in a browser — connect-strava opens the window and stores the credentials, check-strava-connection reports the state. Route exports need a local directory configured in advance.
Setup effort
One command plus credentials — npm install -g @r-huijts/strava-mcp-server, then supply credentials
USE CASES
01
Reviewing how a training block went
Get the athlete id from the profile, pull the recent, year-to-date and all-time totals, then fetch the underlying activities filtered to the date range and sport you care about.
02
Digging into one workout's numbers
Activity details give the summary; the streams give heart rate, power, speed and GPS as time series at the density you choose, and the laps give the split-by-split view. Zones turn raw heart rate into something interpretable.
03
Tracking progress on a climb you keep repeating
List your efforts on a segment across a date window and compare them against the segment's own details, then open a single effort when one of them stands out.
04
Finding somewhere to ride in an unfamiliar city
Search for popular segments inside a bounding box, narrowed by activity type and climb category, then star the ones worth keeping so they are in your own list next time.
05
Getting a planned route onto a bike computer
List the routes you have built, open the one you want, and export it into the configured local directory in whichever format your device reads.
24 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
connect-strava
Connect your Strava account to enable activity tracking. This will open a browser window for secure authentication. Use this when the user asks to connect, link, or authenticate their Strava account.
disconnect-strava
Disconnect your Strava account and remove stored credentials. Use this when the user wants to logout, disconnect, or remove their Strava connection.
explore-segments
Searches for popular segments within a given geographical area.
export-route-gpx
Exports a specific Strava route in GPX format and saves it to a pre-configured local directory.
export-route-tcx
Exports a specific Strava route in TCX format and saves it to a pre-configured local directory.
get-activity-details
Fetches detailed information about a specific activity using its ID.
get-activity-laps
Retrieves detailed lap data for a specific Strava activity.
Use Cases:
- Get complete lap data including timestamps, speeds, and metrics
- Access raw values for detailed analysis or visualization
- Extract specific lap metrics for comparison or tracking
Parameters:
- id (required): The unique identifier of the Strava activity.
Output Format: Returns both a human-readable summary and complete JSON data for each lap, including:
- A text summary with formatted metrics
- Raw lap data containing all fields from the Strava API:
- Unique lap ID and indices
- Timestamps (start_date, start_date_local)
- Distance and timing metrics
- Speed metrics (average and max)
- Performance metrics (heart rate, cadence, power if available)
- Elevation data
- Resource state information
- Activity and athlete references
Notes:
- Requires activity:read scope for public/followers activities, activity:read_all for private activities
- Returns complete data as received from Strava API without omissions
- All numeric values are preserved in their original precision
get-activity-photos
Retrieves photos associated with a specific Strava activity.
Use Cases:
- Fetch all photos uploaded to an activity
- Get photo URLs for display or download
- Access photo metadata including location and timestamps
Parameters:
- id (required): The unique identifier of the Strava activity.
- size (optional): Size of photos to return in pixels (e.g., 100, 600, 2048). If not specified, returns all available sizes.
Output Format: Returns both a human-readable summary and complete JSON data for each photo, including:
- A text summary with photo count and URLs
- Raw photo data containing all fields from the Strava API:
- Photo ID and unique identifier
- URLs for different sizes
- Source (1 = Strava, 2 = Instagram)
- Timestamps (uploaded_at, created_at)
- Location coordinates if available
- Caption if provided
Notes:
- Requires activity:read scope for public/followers activities, activity:read_all for private activities
- Photos may come from Strava uploads or linked Instagram posts
- Returns empty array if activity has no photos
get-activity-streams
Retrieves detailed time-series data streams from a Strava activity. Perfect for analyzing workout metrics, visualizing routes, or performing detailed activity analysis.
Key Features:
- Multiple Data Types: Access various metrics like heart rate, power, speed, GPS coordinates, etc.
- Flexible Resolution: Choose data density from low (~100 points) to high (~10000 points)
- Smart Pagination: Get data in manageable chunks optimized for LLM context limits
- Rich Statistics: Includes min/max/avg for numeric streams
- Dual Format Support: Compact (LLM-optimized) or verbose (human-readable)
- Intelligent Downsampling: Automatically reduce large datasets while preserving key features
Format Options:
- compact (default): Raw arrays, minified JSON, ~70-80% smaller payloads, ideal for LLM processing
- verbose: Human-readable objects with formatted values, backward compatible with legacy format
Common Use Cases:
- Analyzing workout intensity through heart rate zones
- Calculating power metrics for cycling activities
- Visualizing route data using GPS coordinates
- Analyzing pace and elevation changes
- Detailed segment analysis
Output Format:
- Metadata: Activity overview, available streams, data points, units, format info
- Statistics: Summary stats for each stream type (max/min/avg where applicable)
- Data: Time-series data in compact arrays or verbose objects (based on format parameter)
Notes:
- Requires activity:read scope
- Not all streams are available for all activities
- Older activities might have limited data
- Large activities are automatically chunked to ~50KB per message
- Use max_points parameter to downsample very large activities intelligently
get-all-activities
Fetches complete activity history with optional filtering by date range and activity type. Supports pagination to retrieve all activities.
get-athlete-profile
Fetches the profile information for the authenticated athlete, including their unique numeric ID needed for other tools like get-athlete-stats.
get-athlete-stats
Fetches the activity statistics (recent, YTD, all-time) for a specific athlete using their ID. Requires the athleteId obtained from the get-athlete-profile tool.
get-athlete-zones
Retrieves the authenticated athlete's configured heart rate and power zones.
Output includes both a formatted summary and the raw JSON data.
get-recent-activities
Fetches the most recent activities for the authenticated athlete.
get-route
Fetches detailed information about a specific route using its ID.
get-segment
Fetches detailed information about a specific segment using its ID.
get-segment-effort
Fetches detailed information about a specific segment effort using its ID.
get-server-version
Returns the Strava MCP server version and related metadata.
list-athlete-clubs
Lists the clubs the authenticated athlete is a member of.
list-athlete-routes
Lists the routes created by the authenticated athlete, with pagination.
list-segment-efforts
Lists the authenticated athlete's efforts on a specific segment, optionally filtering by date.
list-starred-segments
Lists the segments starred by the authenticated athlete.
star-segment
Stars or unstars a specific segment for the authenticated athlete.
BEFORE YOU INSTALL
What to know first
Tools you get
24 tools when we connected. The project describes 25 tools, including listing your shoes and turning a workout into a Zwift file, so those two may be missing. star-segment is the only tool that changes anything on Strava.
Requires
npx on PATH
Where it runs
Both documented clients run the server on your machine.
CONTEXT COST
Light Standing cost
Rated by the size of the 24 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Server setup
TERMINAL
npm install -g @r-huijts/strava-mcp-serverMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"strava": {
"command": "npx",
"args": [
"-y",
"@r-huijts/strava-mcp-server"
]
}
}
}Claude Code
CLAUDE CODE · TERMINAL
claude mcp add --transport stdio strava -- npx @r-huijts/strava-mcp-server
