Strava MCP Server

Minimalist Strava integration for Claude.

7 focused tools. One-time auth. Zero bloat.

What You Can Ask Claude

• "How was my training this week vs last?"
• "What's my average heart rate on tempo runs?"
• "Break down yesterday's workout by zones"

Tools

Tool	What it does
get_athlete_profile	Your profile info
get_athlete_stats	Totals: recent, YTD, all-time
get_athlete_zones	HR and power zone configuration
list_activities	Browse with date filtering
get_activity_detail	Full workout breakdown with laps and segments
get_activity_zones	Zone distribution with time and percentage per zone
get_segment_effort_streams	Segment analysis with historical comparison

Quick Start with npx

1. Create Strava App     →  strava.com/settings/api → get Client ID + Secret
2. Authorize (one-time)  →  STRAVA_CLIENT_ID=xxx STRAVA_CLIENT_SECRET=xxx \
                            STRAVA_REDIRECT_URI=http://localhost:3000/auth/callback \
                            npx mcp-strava-auth
3. Configure Claude      →  Add to claude_desktop_config.json (see below)
4. Restart Claude        →  Done! Ask Claude about your workouts

1. Create Strava API Application

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

2. Authorize with Strava (one-time setup)

Run the auth server with your Strava credentials:

STRAVA_CLIENT_ID=your_client_id STRAVA_CLIENT_SECRET=your_client_secret STRAVA_REDIRECT_URI=http://localhost:3000/auth/callback npx mcp-strava-auth

Then:

1. Visit http://localhost:3000/auth/strava in your browser
2. Authorize on Strava's page
3. You'll see "Authorization Successful!" when complete
4. The server shuts down automatically

Tokens and credentials are stored securely in ~/.strava-mcp/tokens.json.

3. Configure Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

open ~/Library/Application\ Support/Claude/

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "strava": {
      "command": "npx",
      "args": ["-y", "mcp-strava"]
    }
  }
}

4. Restart Claude Desktop

Restart Claude Desktop to load the MCP server.

Manual Setup (Alternative)

If you prefer to clone and build locally:

1. Create Strava API Application

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

2. Build the Project

git clone https://github.com/adrienlupo/mcp-strava.git
cd mcp-strava
npm install
npm run build

3. Authorize with Strava

Run the authorization server with your Strava credentials:

STRAVA_CLIENT_ID=your_client_id STRAVA_CLIENT_SECRET=your_client_secret STRAVA_REDIRECT_URI=http://localhost:3000/auth/callback npm run auth

Then:

1. Visit http://localhost:3000/auth/strava in your browser
2. Authorize on Strava's page
3. You'll see "Authorization Successful!" when complete
4. The server shuts down automatically

4. Configure Claude Desktop

Add to your Claude Desktop config (claude_desktop_config.json):

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

open ~/Library/Application\ Support/Claude/

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "strava": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-strava/dist/index.js"]
    }
  }
}

5. Restart Claude Desktop

Restart Claude Desktop to load the MCP server.

Development

npm install
npm run build
npm start

License

MIT