Granola MCP

npx add-mcp 'https://mcp.granola.ai/mcp'

Index de la documentation

Récupérez l'index complet de la documentation à l'adresse : https://docs.granola.ai/llms.txt Utilisez ce fichier pour découvrir toutes les pages disponibles avant d'explorer plus loin.

Granola MCP

Connectez Claude, ChatGPT et d'autres outils d'IA à vos notes de réunion Granola via MCP. Interrogez vos notes, recherchez dans les transcriptions et obtenez des informations sur vos réunions dans vos assistants IA préférés.

Connectez vos outils d'IA à vos notes de réunion Granola avec Granola MCP. Une fois connecté, vous pouvez l'utiliser pour : rechercher dans vos notes de réunion, trouver des sujets spécifiques abordés lors de réunions passées, parcourir les dossiers de réunions, extraire des éléments d'action ou des décisions de vos notes, répondre à des questions basées sur votre historique de réunions, et plus encore.

Granola prend en charge l'OAuth basé sur navigateur et l'Autorisation gérée par l'entreprise (EMA) pour les fournisseurs d'identité et les clients MCP compatibles.

Ce que MCP peut accéder

Granola MCP se connecte en tant qu'utilisateur individuel via OAuth navigateur. Avec EMA, le fournisseur d'identité de l'organisation gère l'accès à la place. Les deux méthodes renvoient les notes auxquelles l'utilisateur peut accéder et qui appartiennent à l'espace de travail Granola actif de l'utilisateur, sous réserve des portées d'accès ci-dessous.

Les notes d'autres espaces de travail Granola ne sont pas incluses, même si elles sont visibles dans l'espace de travail actif via le partage.

Portée d'accès	Ce qu'elle peut accéder
Notes personnelles	Notes que vous possédez dans l'espace de travail actif Notes dans l'espace de travail actif partagées directement avec vous Notes dans des dossiers privés de l'espace de travail actif partagées avec vous
Notes publiques	Notes visibles par tous dans l'espace de travail actif Notes dans l'espace Équipe de l'espace de travail actif

Votre forfait et les paramètres de l'espace de travail déterminent les portées utilisées par MCP :

Forfait	Accès MCP
Basic (Gratuit)	Notes personnelles des 30 derniers jours. Certains outils de dossiers, de recherche et de transcription ne sont disponibles que sur les forfaits payants.
Business	Notes personnelles et notes publiques.
Enterprise	Les administrateurs d'espace de travail peuvent configurer les portées disponibles pour les membres. Si aucune portée n'est activée, les membres ne peuvent pas utiliser Granola MCP.

MCP suit l'espace de travail actif sélectionné dans l'application Granola. Si vous appartenez à plusieurs espaces de travail, changez d'espace de travail dans Granola avant de poser une autre question à votre outil d'IA. MCP ne combine pas les notes de plusieurs espaces de travail.

Guide de configuration

Prérequis

• Un compte Granola avec des notes de réunion existantes
• Un outil d'IA prenant en charge MCP, tel que Claude et ChatGPT

Comment se connecter

1. Ouvrez et connectez-vous à Claude

2. Allez dans Paramètres

3. Allez dans Connecteurs, recherchez Granola

4. Connectez-vous, authentifiez-vous et assurez-vous d'être activé lors des
   conversations

1. Ouvrez et connectez-vous à ChatGPT 2. Allez dans Paramètres 3. Recherchez « Granola » et connectez-vous 4. Vous pouvez maintenant @Granola ou simplement demander de référencer vos réunions dans ChatGPT 1. Exécutez `claude` dans votre terminal 2. Exécutez cette commande :

```bash theme={null}
  claude mcp add granola --transport http https://mcp.granola.ai/mcp
```

3. Ouvrez un nouvel onglet de terminal et exécutez `claude` à nouveau
4. Exécutez `/mcp`, sélectionnez le MCP Granola, puis sélectionnez « Authentifier »
5. Demandez à Claude de référencer vos réunions

Vous pouvez vous connecter manuellement au MCP Granola en utilisant l'URL publique{" "} [https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp) comme connexion personnalisée.

Votre outil d'IA doit prendre en charge :

* **Protocole client MCP** utilisant le [transport HTTP Streamable](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **Authentification OAuth 2.0 et découverte des métadonnées** — pour une connexion standard, votre outil doit pouvoir ouvrir une fenêtre de navigateur pour que l'utilisateur se connecte à Granola. Après la connexion, l'outil reçoit un jeton porteur à inclure dans les requêtes suivantes.

Les clients Enterprise peuvent utiliser l'[Autorisation gérée par l'entreprise](#enterprise-managed-authorization) au lieu du flux de connexion Granola standard. Chaque connexion agit toujours au nom d'un utilisateur Granola individuel ; il n'existe pas de clé API ni de méthode d'accès par compte de service pour MCP.

<Info>
  Si vous avez besoin d'un accès par clé API pour des scripts, des automatisations ou des intégrations personnalisées, consultez notre [API Granola](./granola-api) à la place.
</Info>

Autorisation gérée par l'entreprise

L'Autorisation gérée par l'entreprise (EMA) permet à votre entreprise de contrôler l'accès à Granola MCP via son fournisseur d'identité (IdP). Les utilisateurs se connectent à leur client MCP avec leur compte d'entreprise, et l'IdP décide s'ils peuvent se connecter à Granola.

Votre IdP contrôle qui peut se connecter. Les paramètres de l'espace de travail Granola contrôlent à quelles notes ils peuvent accéder.

Avant de commencer

Vous avez besoin de :

• Un espace de travail Granola Enterprise avec SSO configuré
• Un IdP et un client MCP prenant en charge EMA (Granola a testé avec Claude & Okta)
• Un accès administrateur à votre espace de travail Granola et à votre IdP, ou l'aide des administrateurs concernés

Chaque utilisateur doit déjà avoir un compte Granola associé à son identité d'entreprise. S'ils n'ont jamais utilisé le SSO d'entreprise avec Granola auparavant, demandez-leur de se connecter à Granola avec SSO une fois avant d'utiliser EMA.

Configurer EMA

1. Dans Granola, cliquez sur le nom de votre espace de travail dans le coin inférieur gauche, puis sélectionnez Paramètres. Allez dans Paramètres → Espace de travail → Général → Applications et connecteurs → Accès MCP et activez l'accès aux notes que votre entreprise souhaite autoriser.
2. Dans votre IdP, ajoutez ou sélectionnez Granola et activez sa capacité d'autorisation gérée ou de serveur de ressources.
3. Créez une connexion de ressource gérée depuis votre client MCP vers Granola.
4. Saisissez les valeurs ci-dessous. Votre IdP peut utiliser des noms de champs différents ou déduire certaines valeurs automatiquement.

Champ	Valeur
URL de ressource	https://mcp.granola.ai/mcp
URL d'émetteur	https://mcp-auth.granola.ai
Audience ID-JAG	https://mcp-auth.granola.ai
Portée	mcp
ID client à la ressource	L'URL du document de métadonnées d'ID client du client MCP

5. Assignez les utilisateurs ou groupes appropriés à la fois à Granola et au client MCP, puis activez la connexion de ressource gérée.

Avec EMA, les utilisateurs assignés ne terminent pas un flux de consentement OAuth Granola séparé. Leur accès reste soumis à la fois à votre politique IdP et à l'accès MCP configuré dans Granola.

Si votre entreprise crée son propre client MCP

Granola prend en charge les clients confidentiels qui s'authentifient avec private_key_jwt via un document de métadonnées d'ID client (CIMD). Cela permet à votre client de s'authentifier avec sa propre paire de clés au lieu d'un secret client émis par Granola.

Votre client doit implémenter l'extension EMA MCP, obtenir un ID-JAG auprès de l'IdP de l'entreprise et publier un document de métadonnées HTTPS public qui déclare private_key_jwt et un jwks_uri. Utilisez les métadonnées OAuth de Granola pour découvrir les capacités et les points de terminaison pris en charge, et utilisez l'émetteur exact annoncé comme audience de l'assertion client.

Consultez la spécification EMA MCP pour les exigences complètes du protocole.

Exemple : Claude et Okta

Granola a testé EMA avec Claude et Okta Cross App Access (XAA) :

1. Dans Okta, ajoutez l'intégration Granola.
2. Ouvrez l'onglet Serveur de ressources et activez Cross App Access (XAA).
3. Suivez les instructions d'Okta pour configurer un connecteur de serveur de ressources entre Claude et Granola.
4. Utilisez https://claude.ai/oauth/mcp-oauth-client-metadata comme ID client à la ressource.

Outils et descriptions

Outil	Description	Exemples de prompts
query_granola_meetings	Discuter avec Granola	Voir tous les exemples de discussions ici
list_meeting_folders	Forfaits payants uniquement — Liste les dossiers auxquels vous pouvez accéder, y compris l'ID du dossier, le titre, la description et le nombre de notes.	À quels dossiers de réunions ai-je accès ?
list_meetings	Liste les notes de réunion auxquelles vous pouvez accéder, y compris l'ID de la réunion, le titre, la date et les participants. Peut être filtré par dossier sur les forfaits payants.	Quelles réunions ai-je eues avec Sam la semaine dernière ?
get_meetings	Lisez les notes de réunion auxquelles vous pouvez accéder, y compris l'ID de la réunion, le titre, la date, les participants, les notes privées et les notes résumées.	Quels sont les éléments d'action restants pour chaque personne sur ce projet ?
get_meeting_attachment	Affichez les captures d'écran des écrans partagés pendant une réunion, comme des diapositives, des graphiques ou du code.	Qu'y avait-il sur la diapositive de tarification dans la revue d'aujourd'hui ?
get_meeting_transcript	Forfaits payants uniquement — Zoomez sur vos transcriptions, comprend : ID de la réunion, transcription brute	Donnez des citations spécifiques de la façon dont l'équipe a décrit le problème
get_account_info	Renvoie l'e-mail, l'espace de travail actif et les espaces de travail rejoints pour le compte Granola actuellement connecté à cette session MCP — utile pour confirmer que vous avez connecté le bon compte Granola lorsque vous en avez plusieurs (par exemple personnel + professionnel)	À quel compte Granola suis-je connecté ?
switch_workspace	Uniquement disponible si vous appartenez à plusieurs espaces de travail — Changez votre espace de travail Granola actif. Cela le change également dans l'application Granola et dans tout autre outil d'IA connecté à votre compte.	Changez mon espace de travail Granola en Acme
sign_out	Déconnectez cet outil d'IA de votre compte Granola. Pour utiliser un autre compte, reconnectez Granola ensuite.	Déconnectez-moi de Granola

Guide de dépannage

Les limites de débit varieront en fonction de votre forfait d'abonnement Granola et de l'outil MCP que vous utilisez. Les limites de débit sont actuellement en moyenne d'environ 100 requêtes par minute sur tous les outils. Les limites de débit sont sujettes à changement.

<Info>
  Si vous êtes sur le forfait Basic (Gratuit), vous ne pouvez interroger que les notes des 30 derniers
  jours.
</Info>

Si vous recevez un message indiquant que votre agent LLM ne peut pas accéder à vos notes de réunion ou utiliser les outils MCP Granola, essayez de vous ré-authentifier. Si Granola est connecté dans Claude mais affiche **Aucun outil disponible**, reconnectez le connecteur Granola dans Claude pour réinitialiser la connexion :

1. Allez dans [les paramètres du connecteur Claude](https://claude.ai/customize/connectors) sur le web. Vous devez le faire sur claude.ai même si vous utilisez l'application de bureau Claude.
2. Sélectionnez **Granola**.
3. Cliquez sur le menu à trois points en haut à droite.
4. Choisissez **Déconnecter**.
5. Sans actualiser la page ni naviguer ailleurs, choisissez **Connecter** à nouveau
   et terminez l'authentification.

<Info>
  Si vous êtes sur un forfait Claude Team ou Enterprise, vous devrez peut-être qu'un
  administrateur d'espace de travail déconnecte et reconnecte Granola pour vous.
</Info>

Si vous voyez cette erreur après avoir terminé le flux de connexion OAuth, vous avez peut-être authentifié avec une adresse e-mail différente de celle sous laquelle votre compte Granola est enregistré.

Pour vérifier quel e-mail votre compte Granola utilise, ouvrez l'application Granola et allez dans **Paramètres** (<kbd>⌘</kbd> + <kbd>,</kbd> sur macOS, <kbd>Ctrl</kbd> + <kbd>,</kbd> sur Windows). L'e-mail de votre compte est affiché sous votre photo de profil en haut à gauche.

Lors de la reconnexion de MCP, assurez-vous de vous connecter avec cette même adresse e-mail pendant le flux OAuth.

Si votre outil d'IA indique qu'il ne trouve aucune note, ou ne renvoie aucun résultat alors que vous savez que vous avez des réunions, MCP peut être connecté au mauvais compte Granola ou au mauvais espace de travail dans le bon compte.

Demandez à votre outil d'IA : **« À quel compte Granola suis-je connecté ? »** Il utilisera l'outil `get_account_info` pour renvoyer l'e-mail et l'espace de travail actif actuellement connectés à MCP. Ensuite :

• Bon e-mail, mauvais espace de travail : changez d’espace de travail dans l’application de bureau Granola (cliquez sur le nom de votre espace de travail en bas à gauche et sélectionnez le bon). MCP suit votre espace de travail actif, donc la prochaine requête l’utilisera. Vous pouvez aussi demander à votre outil d’IA de changer d’espace de travail pour vous, par exemple : « Changez mon espace de travail Granola à [nom de l’espace de travail]. »

• Mauvais e-mail : suivez les étapes de la section Connecté à Claude avec le mauvais compte ci-dessous (ou l’équivalent pour votre outil d’IA) pour vous déconnecter et vous reconnecter avec le bon compte.

  Voici comment reconnecter Claude MCP avec un autre compte Granola :
  1. Demandez à Claude de se déconnecter de Granola.
  2. Cliquez sur le lien mcp-auth.granola.ai/api/logout qu’il vous fournit.
  3. Demandez à Claude de se reconnecter à Granola, puis connectez-vous avec l’e-mail de votre compte Granola principal.

  La raison pour laquelle une déconnexion/reconnexion normale ne résout pas ce problème est que votre session Granola existante reste active, ce qui évite l’étape de connexion. Se déconnecter via le lien efface cette session, ce qui vous permet de choisir le bon compte.

FAQ générale

Non, vous pouvez utiliser des comptes différents pour votre outil d’IA et Granola. Vous authentifierez le compte Granola auquel votre outil d’IA doit avoir accès. Pour vérifier quel e-mail utilise votre compte Granola, ouvrez l’application Granola et allez dans **Paramètres** (⌘ + , sur macOS, Ctrl + , sur Windows) — l’e-mail de votre compte est affiché sous votre photo de profil en haut à gauche. Tout d’abord, vérifiez quels niveaux d’accès s’appliquent à vous :

* **De base (gratuit) :** notes personnelles des 30 derniers jours.
* **Business :** notes personnelles et notes publiques.
* **Enterprise :** les administrateurs d’espace de travail configurent les niveaux d’accès disponibles pour les membres.

L’accès aux notes personnelles n’inclut pas toutes les notes privées de l’espace de travail. La note doit être la vôtre, partagée directement avec vous, ou dans un dossier privé partagé avec vous. L’accès aux notes publiques inclut les notes visibles par tous dans l’espace de travail, y compris les notes de l’espace Équipe.

MCP ne renvoie également que les notes appartenant à l’espace de travail actif. Si une note a été créée dans un autre espace de travail Granola, MCP ne la renverra pas depuis votre espace de travail actuel, même si vous pouvez la voir dans Granola.

Confirmez aussi que MCP est connecté au bon compte et au bon espace de travail actif en demandant à votre outil d’IA : **« Avec quel compte Granola suis-je connecté ? »**

Cela devrait se produire immédiatement, et vous aurez accès à des outils supplémentaires et à des limites de débit améliorées lors de votre prochaine requête. Pour une connexion OAuth standard via navigateur, non. Granola MCP utilise l’enregistrement dynamique de clients (DCR), ce qui signifie que les identifiants sont gérés automatiquement. Vous n’avez pas besoin de générer ou de saisir un identifiant client ou un secret client.

Si vous utilisez une plateforme tierce (comme Composio) qui affiche des champs d’identifiant client et de secret client, laissez-les vides — la plateforme s’enregistrera automatiquement auprès de Granola lors de la connexion.

La configuration EMA est différente. Votre fournisseur d’identité peut demander un **identifiant client au niveau de la ressource** lors de la création de la connexion gérée. Saisissez l’URL du document de métadonnées d’identifiant client du client MCP. Si vous utilisez un client MCP existant comme Claude, utilisez l’URL fournie par ce client ; vous n’avez pas besoin d’en créer un vous-même ni de saisir un secret client.

Si vous créez votre propre client MCP confidentiel, vous créez et hébergez son document de métadonnées d’identifiant client. L’URL du document est l’identifiant client, et le client s’authentifie avec sa clé privée plutôt qu’avec un secret client émis par Granola. Voir [Si votre entreprise crée son propre client MCP](#if-your-company-builds-its-own-mcp-client).

Oui — tout outil qui implémente la [spécification du client MCP](https://modelcontextprotocol.io/) avec le transport HTTP Streamable peut se connecter à Granola MCP. Votre outil peut utiliser OAuth via navigateur, ou EMA s’il prend en charge l’extension et si votre organisation a configuré un IdP compatible. Voir les sections « Autres outils d’IA » et [Autorisation gérée par l’entreprise](#enterprise-managed-authorization) ci-dessus.

Si vous créez une intégration personnalisée et avez besoin d’aide, contactez [hey@granola.so](mailto:hey@granola.so).

FAQ entreprise

Oui. Les administrateurs d’entreprise peuvent configurer l’accès aux notes disponible pour les membres de l’espace de travail :

1. Allez dans **Paramètres → Espace de travail → Général**.
2. Trouvez **Accès MCP** sous **Applications et connecteurs**.
3. Cliquez sur **Gérer**.
4. Activez **Notes personnelles**, **Notes publiques**, les deux, ou aucun.

Pour empêcher les outils d’IA de lire les transcriptions de réunions, désactivez **Transcriptions de réunions** dans la même boîte de dialogue. Cela s’applique à chaque réunion de votre espace de travail, pour tous ceux qui y ont accès, y compris les administrateurs et les personnes avec qui une note est partagée. Les notes et les résumés restent disponibles. Cette option est activée par défaut.

L’accès dépend de la configuration MCP actuelle de l’espace de travail. Si aucun niveau d’accès n’est activé, les membres n’ont aucun accès MCP jusqu’à ce qu’un administrateur active les notes personnelles, les notes publiques, ou les deux. Les contrôles se trouvent sous **Paramètres → Espace de travail → Général → Applications et connecteurs → Accès MCP**. Tous les membres de l’espace de travail Enterprise peuvent voir le paramètre, mais seuls les administrateurs peuvent le modifier. Si vous avez besoin d’un autre niveau d’accès, demandez à votre administrateur d’espace de travail. Les contrôles d’accès aux notes ne le font pas. Ils déterminent ce que les membres non administrateurs de l’espace de travail peuvent accéder via MCP. Les administrateurs d’entreprise peuvent accéder aux notes personnelles et aux notes publiques via MCP.

L’interrupteur **Transcriptions de réunions** s’applique à tout le monde, y compris les administrateurs.

Cette documentation est construite et hébergée sur Mintlify, une plateforme de documentation pour développeurs.