Talk to your Strava data using AI.

Connect Claude to your Strava account and ask questions in plain English: "How far did I run this month?", "Analyze my last ride", or "Show me my fastest segments."

Once connected, just talk to Claude like you're talking to a friend who has access to all your Strava data:

"How many kilometers did I run this month?"

"Compare my running stats from January to December"

"What's my longest ride ever?"

"Break down my last cycling workout - show me power, heart rate, and cadence"

"How did my heart rate zones look during yesterday's run?"

"What was my average pace for each lap in my interval training?"

"What are the most popular cycling segments near Central Park?"

"Show me my starred segments"

"Export my Sunday morning route as a GPX file"

"Analyze my training load this week"

"How does my current fitness compare to last month?"

"Give me a summary of my cycling performance this year"

Open your Claude Desktop configuration file:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

Add this to the file:

{
  "mcpServers": {
    "strava": {
      "command": "npx",
      "args": ["-y", "@r-huijts/strava-mcp-server"]
    }
  }
}

Close and reopen Claude Desktop to load the new configuration.

Just say to Claude:

"Connect my Strava account"

A browser window will open. Enter your Strava API credentials, authorize the app, and you're done!

That's it! Start asking about your activities.

When you say "Connect my Strava account", here's what happens:

1. A browser window opens showing a setup page
2. Enter your Strava API credentials (Client ID and Client Secret)
3. Click "Continue to Strava" - you'll be redirected to Strava
4. Authorize the app on Strava's website
5. See the success message - you can close the browser
6. Done! Claude confirms you're connected

Your credentials are saved locally at ~/.config/strava-mcp/config.json and persist across sessions.

You need to create a free Strava API application (one-time setup):

1. Go to strava.com/settings/api
2. Click "Create an App" (or view your existing app)
3. Fill in the form:
   • Application Name: Anything you want (e.g., "My Claude Assistant")
   • Category: Choose any
   • Website: Can be anything (e.g., http://localhost)
   • Authorization Callback Domain: Must be localhost
4. Copy your Client ID and Client Secret

That's it! You only need to do this once.

• Check status: "Am I connected to Strava?"
• Reconnect: "Connect my Strava account" (use force: true to reconnect)
• Disconnect: "Disconnect my Strava account"

No installation needed! The npx command in the Quick Start automatically downloads and runs the latest version.

If you prefer to install it once:

npm install -g @r-huijts/strava-mcp-server

Then update your Claude config to use:

{
  "mcpServers": {
    "strava": {
      "command": "strava-mcp-server"
    }
  }
}

Note: Even though the package name is @r-huijts/strava-mcp-server, the executable name remains strava-mcp-server for backward compatibility.

For developers who want to modify the code:

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

Then point Claude to your local build:

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

You: What did I do for exercise this week?

Claude: Looking at your Strava activities this week, you completed:

• Monday: 5.2km run (28:15)
• Wednesday: 45km bike ride (1:32:00)
• Saturday: 10km run (52:30)

Total: 60.2km across 3 activities. Nice consistency!

You: Analyze my last cycling workout in detail

Claude: Here's a breakdown of your ride "Evening Loop" from yesterday:

Overview

• Distance: 42.3 km
• Time: 1:28:45
• Avg Speed: 28.6 km/h

Power Analysis

• Average Power: 185W
• Normalized Power: 198W
• Max Power: 520W

Heart Rate

• Average: 142 bpm
• Max: 175 bpm
• Time in Zone 4+: 23 minutes

Your power-to-heart-rate ratio suggests good aerobic efficiency...

You: Find me some challenging cycling climbs near Boulder, Colorado

Claude: Here are popular climbing segments near Boulder:

1. Flagstaff Road - 5.2km, 6.8% avg grade
2. Sunshine Canyon - 3.8km, 7.2% avg grade
3. Left Hand Canyon - 8.1km, 4.5% avg grade

Want me to star any of these so you can find them easily later?

• Make sure Claude Desktop is running the MCP server (check for errors in Claude)
• Try restarting Claude Desktop
• Check that port 8111 isn't blocked by a firewall

• Your token may have expired - say "Connect my Strava account" to reconnect
• Make sure your Strava API application is still active at strava.com/settings/api

• You need to complete the OAuth flow - say "Connect my Strava account"
• If you're using environment variables, make sure all 4 are set (see Developer section)

• Make sure your claude_desktop_config.json is valid JSON (no trailing commas!)
• Restart Claude Desktop after making config changes
• Check Claude's developer console for error messages

If you're getting a JSONRPC error after updating to @r-huijts/strava-mcp-server:

1. Clear npx cache: Run rm -rf ~/.npm/_npx in terminal
2. Verify config uses @r-huijts/strava-mcp-server (not the old strava-mcp-server)
3. Restart Claude Desktop completely (quit and reopen)
4. Test manually: Run npx -y @r-huijts/strava-mcp-server - you should see "Starting Strava MCP Server v1.2.1..."

npm install
npm run build
npm test

MIT License - see LICENSE file for details.

Questions? Open an issue on GitHub.