Accueil › SEO & IA › Connecter Google Analytics 4 (GA4) à Claude : le guide pas à pas

Explore ton trafic, tes sources et tes conversions en langage normal, directement dans Claude. Sans export, sans tableau croisé, sans coder.

Connecter ton Google Analytics 4 (GA4) à Claude tient en quatre étapes : créer un projet Google Cloud, activer les API Analytics, générer un identifiant OAuth, puis brancher le serveur à Claude. Ça va te prendre 15 minutes. Tu ne le fais qu’une seule fois et c’est gratuit.

4 étapes

dans l’ordre

15 minutes

une seule fois

0 €

tout est gratuit chez Google

Lecture seule

Claude lit, il ne touche à rien

Les données GA4, en mode conversation

Branché à Claude, ton Google Analytics se lit en langage naturel. Tu poses ta question, Claude te sort tes sessions, tes sources et tes conversions déjà agrégées, sans export ni exploration à monter.

Avant, on devait ouvrir GA4, choisir le bon rapport, monter une exploration, croiser deux dimensions sans tout casser, puis exporter pour enfin lire un chiffre. L’interface qui te fait soupirer, tu connais, et c’est fini !

Là, tu écris une phrase. « Donne-moi mes sessions des 30 derniers jours par source. » La réponse arrive dans Claude, déjà mâchée. Tu enchaînes : « D’où viennent mes conversions ? », « Compare à l’an dernier », « Quelles pages ramènent le plus de monde ? ».

C’est tes données GA4, en mode discussion. Je m’en sers avant chaque point client, et je ne reviendrai pas en arrière. Encore faut-il savoir quoi regarder : pose d’abord un plan de mesure clair des KPI que tu souhaites tracker avant de foncer dans les chiffres.

Pour que la magie opère, Claude a juste besoin de lire ton Google Analytics. C’est tout ce que ce guide connecte. Et on reste en lecture seule : il regarde tes chiffres, il ne publie rien, n’efface rien, ne touche à aucun réglage.

Pourquoi on branche ton propre compte Google à Claude ?

Plutôt qu’un « compte de service » (un robot que tu invites dans tes outils), on passe par ton compte Google directement. C’est même ce que Google recommande pour son propre outil Analytics, et la voie la plus simple à garder dans le temps. Claude voit ce que tu vois dans GA4, ni plus ni moins.

Google Analytics 4, c’est l’outil qui mesure qui vient sur ton site et ce qu’ils y font. Branché à Claude, tu l’explores en langage normal, sans tableau croisé.

Ce qu’il faut installer avant de commencer

Deux outils gratuits à installer une seule fois pour connecter Claude et GA4 : pipx et le gcloud CLI.

Le pas à pas ci-dessous utilise Claude Code sur Mac, la version de Claude qui vit dans le Terminal. Sous Windows ou sur Claude Desktop, toute la partie Google est identique : file à la section Pas de Terminal, ou sous Windows ? pour le branchement.

Sur Mac, deux petits outils à installer si tu ne les as pas. Ouvre l’app Terminal et colle ces lignes une par une :

# Homebrew, le gestionnaire d'installation du Mac (saute si tu l'as déjà)
# instructions sur https://brew.sh

brew install pipx                # pour faire tourner le serveur Analytics
brew install --cask gcloud-cli   # l'outil de connexion Google

C’est tout pour la cuisine. Le reste se passe dans ton navigateur et dans le Terminal, écran par écran.

Étape 1 : préparer le projet Google Cloud

Crée un projet Google Cloud gratuit, puis active les deux API Analytics. C’est l’espace et les portes par lesquels Claude viendra lire tes données. Rien de payant, rien de risqué. Je t’explique :

Crée le projet Google Cloud

Va sur console.cloud.google.com et connecte-toi avec le compte Google qui a accès à ton Analytics. C’est le point le plus important du guide : ce compte-là, et pas un autre.

Si Google te propose de créer un projet, accepte. Le nom n’a aucune importance. Si tu as déjà un projet, tu peux le réutiliser. Garde un œil sur l’ID du projet affiché sur la page d’accueil, un truc du genre mon-projet-123, on en aura besoin tout à la fin.

Active les deux API Analytics

Une API, c’est une porte par laquelle deux logiciels se parlent. Par défaut elles sont fermées. Dans la barre de recherche en haut de la console, cherche et active ces deux-là, une par une, avec le bouton bleu Activer :

Google Analytics Data API (tes chiffres)
Google Analytics Admin API (la liste de tes propriétés)

Étape 2 : créer la clé de connexion (OAuth)

Génère un identifiant OAuth : le laissez-passer qui autorise Claude à lire ton Analytics en ton nom. Ça se fait en deux sous-étapes, et un fichier à télécharger.

Règle l’écran d’autorisation OAuth

Dans le menu de gauche, va dans Google Auth Platform (ou cherche « OAuth » dans la barre du haut). Configure-le ainsi :

Type d’utilisateur : Externe.
Laisse l’état sur Test, parfait pour un usage perso.
Dans Utilisateurs test, clique « Add users » et ajoute ta propre adresse Gmail, celle de l’étape 1.

À quoi sert de t’ajouter en utilisateur test ?

Tant que ton appli est en mode Test, seules les adresses listées ici ont le droit de s’en servir. En t’ajoutant, tu t’autorises toi-même. C’est aussi ce qui te fera passer l’écran « application non validée » sans souci à l’étape 3.

Crée le client OAuth et récupère la clé

Toujours dans Google Auth Platform, va dans Clients puis Créer un client :

Type d’application : Application de bureau.
Donne-lui un nom parlant, par exemple Claude Analytics.
Clique Créer, puis Télécharger au format JSON.

Ce petit fichier .json, c’est ta clé. Range-le dans un dossier discret et facile à retrouver. Je te propose ce chemin, qu’on réutilisera tel quel :

# crée le dossier puis dépose ton fichier dedans, renommé proprement
mkdir -p ~/.config/google-mcp
mv ~/Downloads/client_secret_*.json ~/.config/google-mcp/oauth-client.json

Ce fichier est un mot de passe

Ne l’envoie jamais par mail, ne le poste pas sur Discord, ne le mets pas dans un dossier partagé. Il donne accès à tes données : tu le gardes sur ton ordi et c’est tout.

Étape 3 : connecter Claude à Analytics

Deux commandes dans le Terminal : une pour t’identifier auprès de Google, une pour brancher le serveur à Claude. Tu copies, tu colles, et tu valides. Rien de sorcier !

Connecte-toi au bon compte Google

Colle cette commande dans le Terminal. Elle tient sur plusieurs lignes, copie tout le bloc d’un coup :

gcloud auth application-default login \
  --client-id-file=$HOME/.config/google-mcp/oauth-client.json \
  --scopes=openid,\
https://www.googleapis.com/auth/cloud-platform,\
https://www.googleapis.com/auth/analytics.readonly

Une fenêtre de navigateur s’ouvre. Déroule ces étapes :

Choisis ton compte Google, celui de l’étape 1.
Un écran « Google n’a pas validé cette application » s’affiche : c’est normal, l’appli c’est toi. Clique Paramètres avancés, puis Accéder à Claude Analytics (non sécurisé).
Autorise l’accès en lecture.

De retour dans le Terminal, tu dois voir Credentials saved to file. C’est gagné, ta connexion est enregistrée.

Branche le serveur Analytics

Toujours dans le Terminal, colle cette commande. Remplace TON-ID-PROJET par l’ID noté à l’étape 1 :

claude mcp add --scope user google-analytics \
  -e GOOGLE_PROJECT_ID=TON-ID-PROJET \
  -- pipx run analytics-mcp

Puis ferme et rouvre Claude Code. Le nouvel outil ne s’affiche qu’au redémarrage, c’est ce qui piège tout le monde.

Comment connecter Claude à GA4 sans Terminal, ou sous Windows ?

Pour connecter Google Analytics 4 à Claude sans Terminal, la préparation côté Google (projet Cloud, API, identifiant OAuth) reste identique sur tous les systèmes. Seule la façon de brancher le serveur change. La connexion à ton compte, la commande gcloud auth de l’étape 3, passe quand même une fois par le Terminal sur Mac ou par PowerShell sur Windows.

Sur Claude Desktop (Mac ou Windows), tu ne tapes pas claude mcp add. Tu ajoutes le serveur dans la config : dans l’app, Réglages → Développeur → Modifier la config, puis colle ce bloc et enregistre :

{
  "mcpServers": {
    "google-analytics": {
      "command": "pipx",
      "args": ["run", "analytics-mcp"],
      "env": {
        "GOOGLE_PROJECT_ID": "TON-ID-PROJET"
      }
    }
  }
}

Ferme et rouvre Claude Desktop. Sous Windows, installe Python (avec pipx) et le gcloud CLI depuis leurs sites officiels plutôt que par Homebrew ; la commande gcloud auth de l’étape 3 reste la même dans PowerShell.

Si le Terminal te rebute

Des services tiers (Supermetrics, Porter, Windsor.ai) branchent ton Analytics à Claude en un clic, sans ligne de commande. Le compromis, c’est que c’est payant, et tes données passent par leur serveur avant d’arriver dans Claude. Pour un usage perso et gratuit, la méthode ci-dessus reste la plus propre.

Étape 4 : vérifier la connexion avec Claude et interroger GA4

Vérifie que le serveur affiche « Connected », puis pose tes questions en langage naturel. Le plus dur est fait.

Vérifie la connexion Claude et GA4

Dans le Terminal, tape claude mcp list : ton serveur google-analytics doit afficher ✓ Connected. Ensuite, dans Claude, lance-toi :

« Liste mes propriétés Google Analytics. »
« Mes sessions des 30 derniers jours par source et support. »
« Compare mes conversions ce mois-ci avec le mois dernier. »
« Quelles pages ramènent le plus de trafic organique ? »

Si les chiffres remontent, c’est branché !

Questions fréquentes sur la connexion entre GA4 et Claude

Deux blocages reviennent : « aucune propriété » quand Claude est connecté au mauvais compte Google, et « invalid_grant » quand la connexion a expiré. Les deux se règlent en relançant la commande de connexion de l’étape 3.

Claude ne voit aucune propriété GA4, que faire ?

La plupart du temps, la connexion s’est faite avec le mauvais compte Google. Relance la commande de connexion de l’étape 3 et choisis celui qui a vraiment accès à ton Analytics.

Pourquoi la connexion GA4 expire-t-elle après quelques jours dans Claude ?

En mode Test, le jeton d’accès expire après environ une semaine et Claude affiche « invalid_grant ». Relance la commande de connexion de l’étape 3. Pour ne plus y penser, passe ton appli en « Production » dans Google Auth Platform.

Brancher la Search Console à Claude

Brancher la Search Console suit la même logique : même projet Google Cloud, une API et un scope différents. Je t’ai fait le guide jumeau : comment connecter Google Search Console à Claude. Pour brancher les deux d’un coup, ajoute le scope webmasters.readonly à la commande de connexion de l’étape 3.

L'accompagnementLe SEO qui ne s'écroule plus à chaque updateLa méthode SEO réplicable pour construire des stratégies GEO-friendly, sans stresser pour tes recommandations même si les algorithmes changent.Découvrir la méthode →

Connecter Google Analytics 4 (GA4) à Claude : le guide pas à pas