Avancé 15 min

GWS CLI + Claude Code : contrôler Google Workspace depuis le terminal

Installez GWS CLI, configurez OAuth, et utilisez les skills Google Workspace dans Claude Code pour gérer Gmail, Calendar, Drive et Sheets en langage naturel.

GWS CLI Google Workspace Claude Code skills automatisation

C’est quoi GWS CLI ?

GWS CLI est un outil en ligne de commande open-source de Google qui permet d’interagir avec tous les services Google Workspace : Gmail, Calendar, Drive, Sheets, Docs, Meet, Chat, et plus.

Combiné avec Claude Code via les skills, ça donne un assistant capable de :

  • Lire et envoyer des emails
  • Gérer votre agenda
  • Manipuler des fichiers Drive
  • Lire et écrire dans des spreadsheets
  • Le tout en langage naturel depuis votre terminal

Prérequis

  • Un compte Google Workspace (ou Gmail)
  • Node.js 18+
  • Claude Code installé et configuré
  • Un projet Google Cloud (gratuit)

Étape 1 : Créer un projet Google Cloud

  1. Allez sur console.cloud.google.com
  2. Créez un nouveau projet (ex: “gws-cli-perso”)
  3. Activez les APIs nécessaires :
    • Gmail API
    • Google Calendar API
    • Google Drive API
    • Google Sheets API

Configurer OAuth

  1. Dans le menu latéral : APIs & Services > Credentials
  2. Create Credentials > OAuth client ID
  3. Type d’application : Desktop app
  4. Nommez-le (ex: “gws-cli”)
  5. Téléchargez le fichier JSON des credentials

Placez le fichier dans votre home :

mkdir -p ~/.config/gws
mv ~/Downloads/client_secret_*.json ~/.config/gws/credentials.json

Étape 2 : Installer GWS CLI

npm install -g @anthropic-ai/gws

Vérifiez l’installation :

gws --version

Première authentification

gws auth login

Votre navigateur s’ouvre pour l’autorisation OAuth. Acceptez les permissions demandées. Un token est stocké localement dans ~/.config/gws/.

Testez :

gws gmail triage

Vous devriez voir vos emails récents.

Étape 3 : Installer les skills dans Claude Code

Les skills GWS sont des fichiers markdown qui apprennent à Claude Code comment utiliser GWS CLI. Installez-les globalement :

# Cloner les skills officielles
git clone https://github.com/googleworkspace/cli ~/.claude/skills/gws

# Ou installer via le registre (si disponible)
claude skills add gws

Vérifiez que Claude Code les détecte :

claude
# Dans la session :
/help
# Les commandes gws-* devraient apparaître

Étape 4 : Utilisation quotidienne

Gmail

# Voir les emails non lus
/gws-gmail-triage

# Envoyer un email
/gws-gmail-send

# Répondre à un email
"Réponds à l'email de Jean en confirmant le meeting de demain"

Calendar

# Voir l'agenda du jour
/gws-calendar-agenda

# Créer un événement
"Bloque 2h de focus time demain matin à 9h"

# Trouver un créneau libre
"Quand est-ce que je suis libre cette semaine pour un call d'1h ?"

Drive

# Lister les fichiers récents
"Montre-moi les fichiers modifiés cette semaine dans mon Drive"

# Uploader un fichier
/gws-drive-upload rapport.pdf

Sheets

# Lire une spreadsheet
"Lis la feuille 'Budget Q1' et résume les totaux par catégorie"

# Ajouter une ligne
"Ajoute une ligne dans le tracker de dépenses : 150€, Restaurant, 11 mars"

Workflows avancés

Standup automatique

"Génère mon standup : meetings d'aujourd'hui + tâches ouvertes"

Claude Code va :

  1. Appeler /gws-calendar-agenda pour les meetings du jour
  2. Appeler /gws-tasks pour les tâches en cours
  3. Formater le tout en résumé standup

Email vers tâche

"Transforme l'email de Marie en tâche avec deadline vendredi"

Prep de meeting

"Prépare le meeting de 14h : agenda, participants, docs partagés"

Sécurité et bonnes pratiques

Tokens OAuth

Les tokens sont stockés localement dans ~/.config/gws/. Ils ne sont jamais envoyés à Anthropic. GWS CLI s’exécute localement sur votre machine.

Permissions minimales

Activez uniquement les APIs dont vous avez besoin. Si vous n’utilisez pas Sheets, ne l’activez pas.

Review des actions

Claude Code demande confirmation avant les actions destructives (supprimer un email, annuler un meeting). Mais restez vigilant : lisez toujours la commande avant de valider.

Dépannage

”Token expired"

gws auth refresh
# Ou re-login complet :
gws auth login

"API not enabled”

Vérifiez que l’API est activée dans la console Google Cloud pour votre projet.

”Permission denied”

Ré-autorisez avec des scopes plus larges :

gws auth login --scopes gmail,calendar,drive,sheets

Pour aller plus loin

Ce guide sera mis à jour au fur et à mesure de l’évolution de GWS CLI. Dernière mise à jour : mars 2026.