v0.1.3 on PyPI

Give Claude access to your Strava data

An MCP server that turns your runs, rides, and swims into tools for AI-powered coaching, analysis, and conversation.

$ pip install strava-mcp-agent Copy
View Source
13
MCP Tools
16+
Strava Endpoints
1 cmd
Auto Setup
OAuth2
Auto Token Refresh
Tools
Everything in your Strava, accessible to Claude
13 tools covering activities, segments, routes, gear, and AI-ready coaching summaries.
get_athlete
Your profile — name, weight, FTP, bio, and stats
get_athlete_stats
All-time and recent totals for running, cycling, swimming
list_activities
Browse activities with date range and type filtering
get_activity
Full detail — splits, HR, cadence, weather, device
get_activity_zones
Heart-rate and power zone distribution
get_activity_laps
Per-lap pace, HR, and distance breakdown
get_activity_streams
Raw sensor data — GPS, HR, cadence, watts, altitude
get_starred_segments
All your starred segments at a glance
get_segment_efforts
Every effort on a specific segment
get_routes
Routes you've created on Strava
get_gear
Shoe and bike details with mileage tracking
get_clubs
Clubs you belong to
get_running_summary
AI-ready coaching summary — weekly mileage, pace trends, best efforts, HR stats
In Action
Talk to your training data
Just ask Claude naturally. It fetches the data, does the math, and gives you coaching insights.
You
How's my running been this month? Am I improving?
Claude
Looking at your data from the past 4 weeks, you've logged 12 runs totaling 87.3 km. Your average pace improved from 5:42/km to 5:21/km, and your resting HR on easy runs dropped by 4 bpm. Your best 5K effort this month was 24:18 — a 32-second PR. You're trending in the right direction. I'd suggest adding one more easy run per week to build your aerobic base further.
You
Which of my shoes has the most miles?
Claude
Your Nike Pegasus 40 has 847 km on them. Most running shoes are designed for 500–800 km — you might want to consider replacing them soon to avoid injury risk from worn-out cushioning.
You
Compare my heart rate zones on my last tempo run vs my long run
Claude
Your tempo run (Tuesday) spent 68% of the time in Zone 4 (threshold) with avg HR 172. Your long run (Saturday) was mostly Zone 2 (72%) with avg HR 142. That's a solid distribution — your easy runs are actually easy, and your hard runs are hard. Good polarization.
Quick Start
Running in 2 commands
Install, run the setup wizard, and you're done. It auto-configures Claude Desktop for you.

1. Install from PyPI

One command. No extra dependencies to manage.

2. Create a Strava API app (one time)

Go to strava.com/settings/api and fill in:

Application NameAnything (e.g. My Claude MCP)
CategoryPick any
ClubLeave blank
Websitehttp://localhost
Authorization Callback Domainlocalhost ← important!

Click Create. Copy your Client ID (a number) and Client Secret (a long code) from the next page.

3. Run the setup wizard

Run strava-mcp-token in your terminal. It will ask for your Client ID and Secret, open your browser to authorize with Strava, then automatically configure Claude Desktop — detects your OS, finds the right Python, and writes the config file for you.

4. Restart Claude Desktop

That's it. Your 13 Strava tools are ready to use.

Terminal
# Install
$ pip install strava-mcp-agent

# Setup wizard — handles everything
$ strava-mcp-token

=== Strava MCP Setup ===

Enter your Strava CLIENT_ID: 123456
Enter your Strava CLIENT_SECRET: abc...

Opening browser for authorization...
Authorized as: Koushik Maji

Configuring Claude Desktop...
Config written to: ~/Library/.../claude_desktop_config.json
All done! Restart Claude Desktop.
Why
Built for athletes who use AI
⚡

Real-time data

OAuth2 token auto-refresh. Always current, never stale credentials.

🏃

Coaching-ready

The running summary tool computes weekly mileage, pace trends, best efforts, and HR stats in one call.

🔒

Secure by default

Credentials loaded from environment variables only. Never hardcoded, never logged.

🚀

Auto-setup wizard

One command configures everything — detects your OS, finds Python, writes Claude Desktop config. Mac, Linux, and Windows.

📈

Raw sensor streams

GPS, heart rate, cadence, power, altitude — every data point your device recorded.

🛠

Full Strava API

Activities, segments, routes, gear, clubs — if Strava has it, Claude can access it.

Start training with AI

Install in seconds. Ask Claude about your runs in minutes.

$ pip install strava-mcp-agent Copy
View on GitHub