Strava MCP Server

Available Tools

The server exposes the following tools:

Activities Queries

• get_activities(limit: int = 10): Get the authenticated athlete's recent activities
• get_activities_by_date_range(start_date: str, end_date: str, limit: int = 30): Get activities within a specific date range
• get_activity_by_id(activity_id: int): Get detailed information about a specific activity
• get_recent_activities(days: int = 7, limit: int = 10): Get activities from the past X days

Activity Data Format

The server returns activity data with consistent field names and units:

Authentication

To use this server, you'll need to authenticate with the Strava API. Follow these steps:

1. Create a Strava API application:

• Go to Strava API Settings
• Create an application to get your Client ID and Client Secret
• Set the Authorization Callback Domain to localhost

2. Get your refresh token:

• Use the included get_strava_token.py script:

  python get_strava_token.py
  

• Follow the prompts to authorize your application
• The script will save your tokens to a .env file

3. Set environment variables: The server requires the following environment variables:

• STRAVA_CLIENT_ID: Your Strava API Client ID
• STRAVA_CLIENT_SECRET: Your Strava API Client Secret
• STRAVA_REFRESH_TOKEN: Your Strava API Refresh Token

Usage# Claude for Desktop

Update your claude_desktop_config.json to include the following:

{
  "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"
      }
    }
  }
}

Example Queries

Once connected, you can ask Claude questions like:

• "What are my recent activities?"
• "Show me my activities from last week"
• "What was my longest run in the past month?"
• "Get details about my latest cycling activity"

Error Handling

The server provides human-readable error messages for common issues:

• Invalid date formats
• API authentication errors
• Network connectivity problems

License

This project is licensed under the MIT License - see the LICENSE file for details.