Google Calendar MCP

Qu'est-ce que Google Calendar MCP ?

Emma utilise Google Calendar tous les jours pour organiser son travail. Chaque matin, elle se demande la même chose : « qu'est-ce que j'ai prévu aujourd'hui ? ». Sans rien de particulier, son agent IA ne peut pas répondre : il n'a jamais eu accès à son agenda, et il n'a aucune raison d'en connaître le contenu.

Google Calendar MCP est un serveur publié directement par Google, dans le cadre de son programme Workspace Developer Preview. Contrairement à la plupart des serveurs de ce catalogue qui tournent en local sur votre ordinateur, celui-ci est un serveur distant, hébergé par Google : votre client MCP s'y connecte par Internet, avec votre autorisation, plutôt que de le lancer lui-même sur votre machine.

De votre agenda au client IA

Avant de brancher quoi que ce soit, voici le chemin complet que va suivre une question comme celle d'Emma :

• Google Calendar conserve vos événements sur les serveurs de Google.
• L'API Google Calendar est la porte d'entrée technique que Google expose pour interroger ces données.
• L'authentification OAuth vérifie qui vous êtes et récupère votre accord.
• Les permissions (scopes) définissent précisément ce que vous avez autorisé : lecture seule, ou aussi création/modification.
• Le serveur MCP traduit les demandes de votre client IA en appels corrects vers l'API Google, dans la limite des permissions accordées.
• Le client IA (Claude Code, par exemple) reçoit le résultat et vous répond.

Aucune de ces étapes ne peut être court-circuitée : sans autorisation OAuth valide, le serveur ne peut littéralement rien lire.

Ce qu'il permet réellement

Voici la liste exacte des actions exposées par le serveur au moment de la rédaction de ce guide, telle que documentée par Google. Ne partez jamais du principe qu'une capacité existe si elle n'est pas listée ici ou confirmée dans la documentation officielle.

Un point important : les actions d'écriture (créer, modifier, supprimer, répondre) ne sont disponibles que si vous avez vous-même accordé les permissions correspondantes au moment de la connexion. Un accès configuré en lecture seule ne permettra jamais de créer un événement, même si l'outil existe techniquement côté serveur.

Prérequis

Ce serveur demande davantage de préparation qu'un serveur local classique comme Filesystem ou Sequential Thinking. Avant de commencer, assurez-vous d'avoir :

• un compte Google avec un agenda Google Calendar actif ;
• un accès à Google Cloud Console (gratuit pour cet usage) ;
• l'outil gcloud installé sur votre ordinateur, ou l'accès à la console web de Google Cloud ;
• un client MCP compatible avec un transport HTTP distant et l'authentification OAuth : Claude Code (sur un plan payant Pro, Max, Team ou Enterprise au moment de la rédaction) ou Gemini CLI.

Mise en place côté Google

Cette étape se déroule entièrement dans votre navigateur et votre terminal, pas encore dans votre client IA. Créez d'abord un projet dans Google Cloud Console, si vous n'en avez pas déjà un dédié à vos expérimentations. Depuis un terminal connecté à ce projet, activez les deux API nécessaires :

gcloud services enable calendar-json.googleapis.com
gcloud services enable calendarmcp.googleapis.com

Ensuite, configurez un écran de consentement OAuth (nom de l'application, adresse de contact) et créez un identifiant client OAuth 2.0 de type « application web », depuis la section « Identifiants » de la console. Ces étapes se font une seule fois par projet, pas à chaque connexion.

Connecter le serveur à Claude Code

Une fois le projet Google Cloud prêt, ajoutez le serveur distant depuis un terminal, avec la commande dédiée aux serveurs qui utilisent un transport HTTP plutôt qu'une commande locale.

claude mcp add --transport http google-calendar https://calendarmcp.googleapis.com/mcp/v1

Décryptage : --transport http indique que ce serveur ne se lance pas localement, mais qu'on s'y connecte par le réseau. google-calendar est le nom que vous choisissez pour le reconnaître ensuite. La dernière partie est l'adresse officielle du serveur, publiée par Google : ne la modifiez pas.

Comprendre l'écran d'autorisation avant de cliquer

La première fois que vous utilisez ce serveur dans Claude Code, ou en tapant /mcp puis en choisissant de l'autoriser, le parcours suivant se déclenche :

1. Le client (Claude Code) demande un accès au serveur Google Calendar MCP.
2. Votre navigateur s'ouvre automatiquement.
3. Vous vous connectez à votre compte Google, si ce n'est pas déjà fait.
4. Un écran de consentement Google s'affiche, listant précisément les permissions demandées.
5. Vous lisez cet écran, et vous autorisez, ou non.
6. Google renvoie un jeton d'accès au client, sans jamais transmettre votre mot de passe.

Ne cliquez jamais sur « Autoriser » par réflexe. Lisez ce qui est réellement demandé : un accès en lecture seule à vos événements n'est pas la même chose qu'un accès qui permet aussi de créer et supprimer.

Premier test : lire, sans rien modifier

Une fois la connexion autorisée, vérifiez-la avec /mcp dans Claude Code : google-calendar doit apparaître comme connecté. Posez ensuite une question de lecture pure, exactement comme Emma au début de ce guide :

"Quels sont mes événements prévus demain ?"

Ce que vous devriez voir

L'IA doit lister les événements réels de votre agenda pour cette date, avec leurs horaires. Si votre agenda est vide ce jour-là, elle doit vous le dire clairement plutôt que d'inventer un événement : si vous voyez apparaître un rendez-vous qui n'existe pas dans votre vrai Google Calendar, arrêtez-vous et vérifiez la connexion avant de faire confiance à la suite.

Aller plus loin : créer un événement de test

Si votre accès a été autorisé en écriture, vous pouvez tester la création, toujours avec quelque chose de facilement identifiable et réversible.

"Crée un événement de test demain à 17h intitulé Test MCP."

Ensuite, une vérification en trois temps, à ne jamais sauter :

1. Ouvrez Google Calendar directement dans votre navigateur, en dehors de tout client IA.
2. Vérifiez que l'événement « Test MCP » apparaît bien, au bon horaire.
3. Supprimez-le, vous-même ou en le demandant à l'IA, une fois la vérification faite : c'était un test, pas un vrai rendez-vous.

Sécurité et vie privée

Un agenda n'est pas une donnée anodine. Il révèle vos horaires, vos habitudes, parfois le nom et l'adresse e-mail de vos participants, et parfois des informations décrites directement dans le titre ou la description d'un événement (un rendez-vous médical, un entretien confidentiel). Un serveur qui a accès à votre agenda a accès à tout ça.

Les risques concrets à garder en tête : une lecture non désirée d'informations privées si le compte ou le client est mal sécurisé ; une création involontaire d'événement si une demande ambiguë est mal interprétée ; une modification ou une suppression d'un vrai rendez-vous si vous n'avez pas vérifié à quel événement l'IA faisait référence. Sur un agenda professionnel partagé avec une équipe, ces risques touchent aussi les autres personnes invitées.

Le principe de moindre privilège s'applique directement ici : si vous n'avez besoin que de consulter votre emploi du temps, n'accordez pas d'accès en écriture lors de la configuration du client OAuth.

Limites

Ce serveur reste, à la date de rédaction de ce guide, dans un programme Developer Preview chez Google : la disponibilité, les capacités exposées et la procédure d'installation peuvent évoluer. Il ne fonctionne qu'avec un compte Google, il ne synchronise aucun autre calendrier (Outlook, par exemple), et il ne remplace pas une vérification humaine avant un rendez-vous important. Sa mise en place est nettement plus technique que celle d'un serveur local sans authentification.

Dépannage

Si l'écran d'autorisation Google ne s'ouvre jamais, vérifiez que les deux API ont bien été activées dans le bon projet Google Cloud. Si Google affiche un message indiquant que l'application n'est pas vérifiée, c'est un comportement attendu tant que votre projet reste en développement : ajoutez votre propre adresse Google comme utilisateur de test dans l'écran de consentement. Si /mcp affiche le serveur comme déconnecté après un moment, le jeton a probablement expiré : relancez l'autorisation depuis Claude Code.

À vous de jouer

Demandez à l'IA quels sont vos trois prochains événements, sans reprendre mot pour mot la question posée dans ce guide. Vérifiez ensuite la réponse directement dans Google Calendar, sans passer par l'IA.

Foire aux questions (FAQ)

Guides recommandés