Strava MCP Server

An MCP (Model Context Protocol) server that connects Claude to your Strava data. Query your activities, stats, and athlete profile directly from Claude Desktop or any MCP-compatible client.

Features

• OAuth Authentication: Secure authentication with automatic token refresh
• Activity Data: Get recent activities, detailed activity info, and stats
• Athlete Profile: Access your Strava profile and statistics

Installation

Prerequisites

1. Python 3.10+ installed
2. Strava API Application: Create one at https://www.strava.com/settings/api
   • Set the "Authorization Callback Domain" to 127.0.0.1

Install from GitHub

pip install git+https://github.com/bronteee/strava-mcp.git

Or with uv:

uv pip install git+https://github.com/bronteee/strava-mcp.git

Configure Claude Desktop

Add to your Claude Desktop configuration file:

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

{
  "mcpServers": {
    "strava": {
      "command": "strava-mcp",
      "env": {
        "STRAVA_CLIENT_ID": "your_client_id",
        "STRAVA_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

If installed with uv, use:

{
  "mcpServers": {
    "strava": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/bronteee/strava-mcp.git", "strava-mcp"],
      "env": {
        "STRAVA_CLIENT_ID": "your_client_id",
        "STRAVA_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

Usage

Authentication

1. Ask Claude: "Connect to my Strava account"
2. Claude will provide an authorization URL
3. Open the URL in your browser and authorize the app
4. You're connected for the current session

Note: Tokens are stored in memory only. You'll need to re-authenticate each time Claude Desktop restarts.

Available Tools

Example Prompts

• "Show me my last 5 Strava activities"
• "What were my running stats this year?"
• "Get details for my most recent ride"
• "How many miles did I run last month?"

Development

Setup

git clone https://github.com/bronteee/strava-mcp.git
cd strava-mcp
uv sync --dev

Run Tests

uv run pytest

Type Check

uv run ty check src

Run the Server Manually

# Set environment variables
export STRAVA_CLIENT_ID=your_client_id
export STRAVA_CLIENT_SECRET=your_client_secret

# Run the server
strava-mcp

Security

• Tokens are stored in memory only and cleared when the server stops
• Client credentials are passed via environment variables, never stored in files
• OAuth flow uses localhost callback - no external servers involved

License

MIT