Strava MCP Server
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Integrations
Provides access to the Strava API, allowing queries for athlete activities including recent activities, activities by date range, specific activity details, and activities from a recent time period. Data returned includes activity metrics like distance, time, speed, elevation, and calories.
Strava MCP Server
A Model Context Protocol (MCP) server that provides access to the Strava API. It allows language models to query athlete activities data from the Strava API.
Available Tools
The server exposes the following tools:
Activities Queries
get_activities(limit: int = 10): Get the authenticated athlete's recent activitiesget_activities_by_date_range(start_date: str, end_date: str, limit: int = 30): Get activities within a specific date rangeget_activity_by_id(activity_id: int): Get detailed information about a specific activityget_recent_activities(days: int = 7, limit: int = 10): Get activities from the past X days
Dates should be provided in ISO format (YYYY-MM-DD).
Activity Data Format
The server returns activity data with consistent field names and units:
| Field | Description | Unit |
|---|---|---|
name | Activity name | - |
sport_type | Type of sport | - |
start_date | Start date and time | ISO 8601 |
distance_metres | Distance | meters |
elapsed_time_seconds | Total elapsed time | seconds |
moving_time_seconds | Moving time | seconds |
average_speed_mps | Average speed | meters per second |
max_speed_mps | Maximum speed | meters per second |
total_elevation_gain_metres | Total elevation gain | meters |
elev_high_metres | Highest elevation | meters |
elev_low_metres | Lowest elevation | meters |
calories | Calories burned | kcal |
start_latlng | Start coordinates | [lat, lng] |
end_latlng | End coordinates | [lat, lng] |
Authentication
To use this server, you'll need to authenticate with the Strava API. Follow these steps:
- Create a Strava API application:
- Go to Strava API Settings
- Create an application to get your Client ID and Client Secret
- Set the Authorization Callback Domain to
localhost
- Get your refresh token:
- Use the included
get_strava_token.pyscript:
Copy- Follow the prompts to authorize your application
- The script will save your tokens to a
.envfile
- Use the included
- Set environment variables:
The server requires the following environment variables:
STRAVA_CLIENT_ID: Your Strava API Client IDSTRAVA_CLIENT_SECRET: Your Strava API Client SecretSTRAVA_REFRESH_TOKEN: Your Strava API Refresh Token
Usage
Claude for Desktop
Update your claude_desktop_config.json (located in ~/Library/Application\ Support/Claude/claude_desktop_config.json on macOS and %APPDATA%/Claude/claude_desktop_config.json on Windows) to include the following:
Claude Web
For Claude Web, you can run the server locally and connect it using the MCP extension.
Example Queries
Once connected, you can ask Claude questions like:
- "What are my recent activities?"
- "Show me my activities from last week"
- "What was my longest run in the past month?"
- "Get details about my latest cycling activity"
Error Handling
The server provides human-readable error messages for common issues:
- Invalid date formats
- API authentication errors
- Network connectivity problems
License
This project is licensed under the MIT License - see the LICENSE file for details.
You must be authenticated.
A Model Context Protocol server that provides language models with access to Strava API data, allowing them to query and analyze athlete activities from Strava.