Strava

MCP server for Strava API integration

python

18

GitHub Stars

python

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "tomekkorbak-strava-mcp-server": {
      "command": "uvx",
      "args": [
        "strava-mcp-server"
      ],
      "env": {
        "STRAVA_CLIENT_ID": "YOUR_CLIENT_ID",
        "STRAVA_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "STRAVA_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN"
      }
    }
  }
}

You can access your Strava athlete data through a dedicated MCP server that exposes Strava API endpoints as queryable tools. This server lets you retrieve activities, filter by date, and inspect details of individual activities, all from your preferred MCP-enabled assistant or client.

How to use

Connect your MCP client to the Strava MCP Server to start querying your data. Once connected, you can ask for your recent activities, filter activities by a date range, fetch details for a specific activity, or retrieve activities from the past several days. Use the server’s tools to request data and your client will render results in a readable format.

How to install

Prerequisites you need before installing the Strava MCP Server: a running MCP runtime (UVX) and Python available for token retrieval. Ensure you have network access to authorize your Strava application.

Obtain Strava API credentials and refresh token.
Obtain an access token using the token script (you will store tokens in a .env file for use by the MCP server). Run the following command and follow the prompts.
Create a configuration block for your MCP client to connect to the Strava MCP Server.
Start using the server with your MCP client.

Configuration and usage notes

Environment variables required to run the Strava MCP Server are your Strava API credentials. You will provide these via the MCP configuration or environment in your client setup.

The server implements a set of activity-related queries that you can execute through your MCP client to retrieve Strava data efficiently.

If you are using Claude Desktop, you will configure the MCP server connection in your client’s settings to point to the Strava MCP Server using the provided runtime command and environment variables.

Example configuration snippet

{
  "mcpServers": {
    "strava": {
      "command": "uvx",
      "args": [
        "strava-mcp-server"
      ],
      "env": {
        "STRAVA_CLIENT_ID": "YOUR_CLIENT_ID",
        "STRAVA_CLIENT_SECRET": "YOUR_CLIENT_SECRET",
        "STRAVA_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN"
      }
    }
  }
}

Available tools

get_activities

Retrieve the authenticated athlete's recent activities with an optional limit.

get_activities_by_date_range

Fetch activities that fall within a specified start and end date range, with an optional limit.

get_activity_by_id

Get detailed information about a single activity by its ID.

get_recent_activities

Retrieve activities from the past N days, with a configurable maximum number of results.