1. Accéder à la Google Cloud Console via le navigateur ;
2. Créer un nouveau projet avec un nom descriptif (par exemple, "gcalendar agent") ;
3. Passer au projet nouvellement créé une fois l'initialisation terminée.

0. Si demandé, cliquer sur "Configurer l’écran de consentement" ;
1. Saisir le nom de l’application (par exemple, "calendar mcp") ;
2. Spécifier l’adresse e-mail autorisée ;
3. Sélectionner "Audience externe" pour les restrictions de type d’utilisateur ;
4. Fournir les informations de contact en utilisant la même adresse e-mail ;
5. Accepter les exigences de la politique de données utilisateur.

1. Accéder à APIs et services → Bibliothèque ;
2. Rechercher "Calendar API" ;
3. Sélectionner le premier résultat et activer l’accès à l’API ;
4. Vérifier que le statut de l’API indique "Activée".

1. Accéder à la section Identifiants dans APIs et services ;
2. Créer un ID client OAuth ;
3. Sélectionner "Application de bureau" comme type d’application ;
4. Télécharger le fichier d’identifiants JSON généré ;
5. Stocker temporairement le fichier sur le bureau pour un accès facile (optionnel).

Dans Claude, copiez et collez l'invite suivante :

Create a new folder named projects in my Documents directory to store all MCP servers.
Then clone the repository using: git clone https://github.com/nspady/google-calendar-mcp.git into that folder.
After cloning, move the file gcp-oauth.keys.json from my Desktop into the cloned repo.

Claude créera automatiquement le dossier projects, clonera le dépôt, déplacera le fichier JSON d'identifiants dans le dépôt.

• Ouvrez votre dossier Documents ;
• Vérifiez la présence d'un nouveau dossier projects ;
• À l'intérieur, dans le dépôt cloné, trouvez le nouveau dossier (par exemple, google-calendar-mcp). Le fichier gcp-oauth.keys.json doit être placé dans le dépôt.

Exécutez l'invite suivante dans Claude :

add next config block to claude config file
    "google-calendar": {
      "command": "npx",
      "args": ["@cocal/google-calendar-mcp"],
      "env": {
        "GOOGLE_OAUTH_CREDENTIALS": "/path/to/your/gcp-oauth.keys.json"
      }
    }

• Ouvrez les paramètres → raccourci : Cmd + , sur Mac ou Ctrl + , sur Windows ;
• Accédez à l’onglet Développeur → cliquez sur Modifier la configuration ;
• Ouvrez le fichier claude_desktop_config.json avec un éditeur de texte. Le fichier JSON doit maintenant afficher le nouveau bloc de configuration avec le chemin correct vers votre fichier d'identifiants ;
• Si c'est correct, fermez la fenêtre de configuration.

• Quittez complètement Claude (Mac : Cmd + Q, Windows : Alt + F4) ;
• Redémarrez l’application ;
• Au lancement, vous serez redirigé vers une page d’authentification Google :
  • Sélectionnez le même compte Google utilisé pour le projet ;
  • Lorsque cela est demandé, cliquez sur Autoriser pour accorder l’accès ;
  • Une fois l’authentification réussie, fermez l’onglet.

Dans votre Terminal (Mac) ou Invite de commandes (Windows), commencez depuis le répertoire racine (par défaut) et naviguez jusqu’au dossier où vous stockerez tous les futurs répertoires d’agents IA.

• Pour accéder à un dossier, utilisez la commande cd folder_name, par exemple :

cd Documents

Pour créer un nouveau dossier, utilisez la commande mkdir new_folder_name, par exemple :

mkdir projects

Et naviguez vers ce nouveau dossier avec la commande cd command :

cd projects

Utilisez la commande git clone link pour cloner le dépôt GitHub :

git clone https://github.com/nspady/google-calendar-mcp.git

Déplacez-vous dans le dépôt nouvellement créé en utilisant la commande cd :

cd google-calendar-mcp

Vous devez maintenant déplacer le fichier contenant les identifiants vers le dossier de l'agent IA (google_calendar_mcp). Vous pouvez le faire manuellement en déplaçant l'icône du fichier vers le dossier ouvert dans l'explorateur de fichiers. Ou utiliser le Terminal/Ligne de commande et copier le fichier avec la commande cp path/to/file_name ., par exemple :

cp ~/Desktop/gsp-oauth.keys.json .

Le point (.) à la fin indique que le répertoire courant est la destination.

Vous pouvez vérifier si le fichier JSON a bien été déplacé dans le dossier en utilisant la commande ls dans le Terminal et en trouvant le nom du fichier dans la liste.

Après avoir déplacé le fichier, supprimez-le de son emplacement d'origine (par exemple, le Bureau).

Dans le Terminal/Ligne de commande, utilisez

npm install

Cette commande télécharge tous les paquets et dépendances nécessaires.

Poursuivez dans le Terminal/Ligne de commande et exécutez

npm start

Cette commande lance le script de démarrage par défaut défini dans le fichier package.json du projet, ce qui lance généralement l'application ou le serveur ; dans notre cas, cela lance le flux d'authentification.

1. La fenêtre du navigateur s'ouvre automatiquement ;
2. Sélectionnez le compte Google approprié ;
3. Accordez les autorisations d'accès au calendrier ;
4. Confirmez le message "Authentification réussie" ;
5. Fermez la fenêtre du navigateur.

Intégration Claude Desktop

• Copier le bloc de configuration :

    "google-calendar": {
      "command": "node",
      "args": [
        "/path/to/build/index.js"
      ]
    }

• Accédez au fichier de configuration Claude via Command/Ctrl + , → "Développeur" → "Modifier la configuration" ;
• Ouvrez le fichier de configuration claude_desktop_config.json avec un éditeur de texte ;
• Ajoutez la nouvelle configuration comme bloc suivant après les configurations existantes et avant les deux dernières accolades fermantes ;
• Assurez-vous de la syntaxe JSON correcte avec une bonne fermeture des accolades et des virgules après chaque bloc de configuration sauf le dernier.

Dans le Terminal/Ligne de commande, exécutez

pwd

Copiez le chemin complet du répertoire et insérez-le avant "/build" dans le fichier de configuration.

Enregistrez le fichier de configuration avec Command/Ctrl + S.

1. Redémarrez complètement Claude Desktop ;
2. Vérifiez que le nouveau serveur apparaît dans les outils disponibles.