MCP Sports Coach — Strava & Garmin

Serveur MCP (Model Context Protocol) qui connecte Claude aux comptes Strava et Garmin Connect pour analyser les activités sportives, le sommeil, la récupération et bien plus.

Outils disponibles

Strava

Garmin Connect

Related MCP server: Garmin Health MCP Server

Installation

Prérequis

• Python 3.12+

• uv (gestionnaire de paquets)

• Un compte Strava avec une application enregistrée sur strava.com/settings/api

1. Cloner et installer

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

2. Configurer les credentials Strava

Copier .env.example en .env et renseigner les credentials Strava :

cp .env.example .env

STRAVA_CLIENT_ID=client_id
STRAVA_CLIENT_SECRET=client_secret

Ces valeurs sont disponibles sur strava.com/settings/api. Régler l'Authorization Callback Domain sur localhost.

3. (Optionnel) Authentifier Garmin

Lancer ce script une seule fois en terminal pour sauvegarder le token Garmin localement :

uv run garmin_login.py

Les identifiants Garmin ne transitent jamais par Claude.

4. Configurer Claude Desktop

Ajouter la configuration suivante dans claude_desktop_config.json :

{
  "mcpServers": {
    "sports-coach": {
      "command": "uv",
      "args": ["run", "python", "strava_mcp.py"],
      "cwd": "/chemin/vers/mcp-strava"
    }
  }
}

5. Authentifier Strava dans Claude

Au premier lancement, utiliser l'outil authenticate dans Claude. Une fenêtre Strava s'ouvre pour autoriser l'accès, puis le token est sauvegardé localement.

Sécurité

• Le fichier .env (credentials API) n'est jamais commité

• Les tokens OAuth (strava_token.json, garth_tokens/) restent en local uniquement

• Les identifiants Garmin ne sont jamais envoyés à Claude, seulement au serveur Garmin

Stack

• MCP Python SDK — FastMCP

• httpx — requêtes HTTP async

• garminconnect — API Garmin non-officielle

• python-dotenv — gestion des variables d'environnement