Granola MCP

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

Dokumentationsindex

Rufen Sie den vollständigen Dokumentationsindex ab unter: https://docs.granola.ai/llms.txt Verwenden Sie diese Datei, um alle verfügbaren Seiten zu entdecken, bevor Sie weiter erkunden.

Granola MCP

Verbinden Sie Claude, ChatGPT und andere KI-Tools über MCP mit Ihren Granola-Besprechungsnotizen. Durchsuchen Sie Ihre Notizen, suchen Sie in Transkripten und erhalten Sie Besprechungseinblicke in Ihren bevorzugten KI-Assistenten.

Verbinden Sie Ihre KI-Tools mit Ihren Granola-Besprechungsnotizen über Granola MCP. Nach der Verbindung können Sie damit: Ihre Besprechungsnotizen durchsuchen, bestimmte Themen finden, die in früheren Besprechungen besprochen wurden, Besprechungsordner durchsuchen, Aktionspunkte oder Entscheidungen aus Ihren Notizen extrahieren, Fragen basierend auf Ihrer Besprechungshistorie beantworten und vieles mehr.

Granola unterstützt browserbasiertes OAuth und Enterprise-Managed Authorization (EMA) für kompatible Identitätsanbieter und MCP-Clients.

Was MCP zugreifen kann

Granola MCP verbindet sich als einzelner Benutzer über Browser-OAuth. Mit EMA verwaltet der Identitätsanbieter der Organisation den Zugriff stattdessen. Beide Methoden geben Notizen zurück, auf die der Benutzer zugreifen kann und die zum aktiven Granola-Arbeitsbereich des Benutzers gehören, vorbehaltlich der unten aufgeführten Zugriffsbereiche.

Notizen aus anderen Granola-Arbeitsbereichen sind nicht enthalten, selbst wenn sie im aktiven Arbeitsbereich durch Freigabe sichtbar sind.

Zugriffsbereich	Worauf kann zugegriffen werden
Persönliche Notizen	Notizen, die Sie im aktiven Arbeitsbereich besitzen Notizen im aktiven Arbeitsbereich, die direkt mit Ihnen geteilt wurden Notizen in privaten Ordnern im aktiven Arbeitsbereich, die mit Ihnen geteilt wurden
Öffentliche Notizen	Notizen, die für alle im aktiven Arbeitsbereich sichtbar sind Notizen im Team-Bereich des aktiven Arbeitsbereichs

Ihr Plan und Ihre Arbeitsbereichseinstellungen bestimmen, welche Bereiche MCP verwendet:

Plan	MCP-Zugriff
Basic (Kostenlos)	Persönliche Notizen aus den letzten 30 Tagen. Einige Ordner-, Such- und Transkript-Tools sind nur in kostenpflichtigen Plänen verfügbar.
Business	Persönliche Notizen und öffentliche Notizen.
Enterprise	Arbeitsbereichsadministratoren können konfigurieren, welche Bereiche für Mitglieder verfügbar sind. Wenn kein Bereich aktiviert ist, können Mitglieder Granola MCP nicht verwenden.

MCP folgt dem aktiven Arbeitsbereich, der in der Granola-App ausgewählt ist. Wenn Sie zu mehr als einem Arbeitsbereich gehören, wechseln Sie in Granola den Arbeitsbereich, bevor Sie Ihrem KI-Tool eine weitere Frage stellen. MCP kombiniert keine Notizen über mehrere Arbeitsbereiche hinweg.

Einrichtungsanleitung

Voraussetzungen

• Ein Granola-Konto mit vorhandenen Besprechungsnotizen
• KI-Tool, das MCP unterstützt, wie Claude und ChatGPT

So verbinden Sie sich

1. Öffnen Sie Claude und melden Sie sich an

2. Gehen Sie zu Einstellungen

3. Gehen Sie zu Connectors, suchen Sie nach Granola

4. Verbinden, authentifizieren und stellen Sie sicher, dass Sie beim
   Chatten aktiviert sind

1. Öffnen Sie ChatGPT und melden Sie sich an 2. Gehen Sie zu Einstellungen 3. Suchen Sie nach „Granola" und verbinden Sie 4. Sie können jetzt @Granola verwenden oder einfach darum bitten, Ihre Besprechungen in ChatGPT zu referenzieren 1. Führen Sie `claude` in Ihrem Terminal aus 2. Führen Sie diesen Befehl aus:

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

3. Öffnen Sie einen neuen Terminal-Tab und führen Sie `claude` erneut aus
4. Führen Sie `/mcp` aus, wählen Sie das Granola MCP und wählen Sie „Authentifizieren"
5. Bitten Sie Claude, Ihre Besprechungen zu referenzieren

Sie können sich manuell mit dem Granola MCP verbinden, indem Sie die öffentliche URL{" "} [https://mcp.granola.ai/mcp](https://mcp.granola.ai/mcp) als benutzerdefinierte Verbindung verwenden.

Ihr KI-Tool muss Folgendes unterstützen:

* **MCP-Client-Protokoll** mit [Streamable-HTTP-Transport](https://modelcontextprotocol.io/specification/2025-03-26/basic/transports#streamable-http)
* **OAuth-2.0-Authentifizierung und Metadaten-Erkennung** — für eine Standardverbindung muss Ihr Tool in der Lage sein, ein Browserfenster zu öffnen, damit sich der Benutzer bei Granola anmelden kann. Nach der Anmeldung erhält das Tool ein Bearer-Token, das in nachfolgende Anfragen aufgenommen wird.

Enterprise-Clients können [Enterprise-Managed Authorization](#enterprise-managed-authorization) anstelle des standardmäßigen Granola-Anmeldevorgangs verwenden. Jede Verbindung handelt weiterhin im Namen eines einzelnen Granola-Benutzers; es gibt keine API-Schlüssel- oder Dienstkontozugriffsmethode für MCP.

<Info>
  Wenn Sie API-Schlüsselzugriff für Skripte, Automatisierungen oder benutzerdefinierte Integrationen benötigen, lesen Sie stattdessen unsere [Granola API](./granola-api).
</Info>

Enterprise-Managed Authorization

Enterprise-Managed Authorization (EMA) ermöglicht Ihrem Unternehmen, den Zugriff auf Granola MCP über seinen Identitätsanbieter (IdP) zu steuern. Benutzer melden sich mit ihrem Firmenkonto bei ihrem MCP-Client an, und der IdP entscheidet, ob sie sich mit Granola verbinden können.

Ihr IdP steuert, wer sich verbinden kann. Die Arbeitsbereichseinstellungen von Granola steuern, auf welche Notizen sie zugreifen können.

Bevor Sie beginnen

Sie benötigen:

• Einen Granola-Enterprise-Arbeitsbereich mit konfiguriertem SSO
• Einen IdP und MCP-Client, die EMA unterstützen (Granola hat mit Claude & Okta getestet)
• Administratorzugriff auf Ihren Granola-Arbeitsbereich und IdP oder Hilfe von den entsprechenden Administratoren

Jeder Benutzer sollte bereits ein Granola-Konto haben, das mit seiner Unternehmensidentität verknüpft ist. Wenn sie SSO zuvor nicht mit Granola verwendet haben, bitten Sie sie, sich einmal mit SSO bei Granola anzumelden, bevor sie EMA verwenden.

EMA konfigurieren

1. Klicken Sie in Granola unten links auf Ihren Arbeitsbereichsnamen und wählen Sie dann Einstellungen. Gehen Sie zu Einstellungen → Arbeitsbereich → Allgemein → Apps & Connectors → MCP-Zugriff und aktivieren Sie den Notizzugriff, den Ihr Unternehmen zulassen möchte.
2. Fügen Sie in Ihrem IdP Granola hinzu oder wählen Sie es aus und aktivieren Sie dessen verwaltete Autorisierungs- oder Ressourcenserverfunktion.
3. Erstellen Sie eine verwaltete Ressourcenverbindung von Ihrem MCP-Client zu Granola.
4. Geben Sie die folgenden Werte ein. Ihr IdP verwendet möglicherweise andere Feldnamen oder leitet einige Werte automatisch ab.

Feld	Wert
Ressourcen-URL	https://mcp.granola.ai/mcp
Aussteller-URL	https://mcp-auth.granola.ai
ID-JAG-Zielgruppe	https://mcp-auth.granola.ai
Bereich	mcp
Client-ID bei Ressource	Die Client-ID-Metadaten-Dokument-URL des MCP-Clients

5. Weisen Sie die entsprechenden Benutzer oder Gruppen sowohl Granola als auch dem MCP-Client zu und aktivieren Sie dann die verwaltete Ressourcenverbindung.

Mit EMA durchlaufen zugewiesene Benutzer keinen separaten Granola-OAuth-Zustimmungsvorgang. Ihr Zugriff bleibt sowohl Ihrer IdP-Richtlinie als auch dem in Granola konfigurierten MCP-Zugriff unterworfen.

Wenn Ihr Unternehmen einen eigenen MCP-Client erstellt

Granola unterstützt vertrauliche Clients, die sich mit private_key_jwt über ein Client-ID-Metadaten-Dokument (CIMD) authentifizieren. Dadurch kann sich Ihr Client mit einem eigenen Schlüsselpaar anstelle eines von Granola ausgestellten Client-Geheimnisses authentifizieren.

Ihr Client muss die MCP-EMA-Erweiterung implementieren, ein ID-JAG vom IdP des Unternehmens erhalten und ein öffentliches HTTPS-Metadaten-Dokument veröffentlichen, das private_key_jwt und ein jwks_uri deklariert. Verwenden Sie die OAuth-Metadaten von Granola, um die unterstützten Funktionen und Endpunkte zu ermitteln, und verwenden Sie den exakt beworbenen Aussteller als Zielgruppe der Client-Assertion.

Siehe die MCP-EMA-Spezifikation für die vollständigen Protokollanforderungen.

Beispiel: Claude und Okta

Granola hat EMA mit Claude und Okta Cross App Access (XAA) getestet:

1. Fügen Sie in Okta die Granola-Integration hinzu.
2. Öffnen Sie die Registerkarte Ressourcenserver und aktivieren Sie Cross App Access (XAA).
3. Befolgen Sie die Anweisungen von Okta zum Konfigurieren eines Ressourcenserver-Connectors zwischen Claude und Granola.
4. Verwenden Sie https://claude.ai/oauth/mcp-oauth-client-metadata als Client-ID bei Ressource.

Tools und Beschreibungen

Tool	Beschreibung	Beispielaufforderungen
query_granola_meetings	Chat mit Granola	Vollständige Chat-Beispiele hier ansehen
list_meeting_folders	Nur kostenpflichtige Pläne — Listen Sie Ordner auf, auf die Sie zugreifen können, einschließlich Ordner-ID, Titel, Beschreibung und Notizanzahl.	Auf welche Besprechungsordner habe ich Zugriff?
list_meetings	Listen Sie Besprechungsnotizen auf, auf die Sie zugreifen können, einschließlich Besprechungs-ID, Titel, Datum und Teilnehmer. Kann auf kostenpflichtigen Plänen nach Ordner gefiltert werden.	Welche Besprechungen hatte ich letzte Woche mit Sam?
get_meetings	Lesen Sie Besprechungsnotizen, auf die Sie zugreifen können, einschließlich Besprechungs-ID, Titel, Datum, Teilnehmer, private Notizen und zusammengefasste Notizen.	Was sind die verbleibenden Aktionspunkte für jede Person in diesem Projekt?
get_meeting_attachment	Zeigen Sie Screenshots von Bildschirmen an, die während einer Besprechung geteilt wurden, wie Folien, Diagramme oder Code.	Was war auf der Preisfolie in der heutigen Überprüfung?
get_meeting_transcript	Nur kostenpflichtige Pläne — Vergrößern Sie Ihre Transkripte, enthält: Besprechungs-ID, rohes Transkript	Geben Sie spezifische Zitate darüber, wie das Team das Problem beschrieben hat
get_account_info	Gibt die E-Mail, den aktiven Arbeitsbereich und die beigetretenen Arbeitsbereiche für das Granola-Konto zurück, das derzeit mit dieser MCP-Sitzung verbunden ist — nützlich, um zu bestätigen, dass Sie das richtige Granola-Konto verbunden haben, wenn Sie mehrere haben (z. B. privat + beruflich)	Mit welchem Granola-Konto bin ich angemeldet?
switch_workspace	Nur verfügbar, wenn Sie zu mehr als einem Arbeitsbereich gehören — Ändern Sie Ihren aktiven Granola-Arbeitsbereich. Dies ändert ihn auch in der Granola-App und in allen anderen KI-Tools, die mit Ihrem Konto verbunden sind.	Wechseln Sie meinen Granola-Arbeitsbereich zu Acme
sign_out	Melden Sie dieses KI-Tool von Ihrem Granola-Konto ab. Um ein anderes Konto zu verwenden, verbinden Sie Granola danach erneut.	Melden Sie mich von Granola ab

Fehlerbehebungsanleitung

Die Ratenlimits variieren je nach Ihrem Granola-Abonnementplan und dem MCP-Tool, das Sie verwenden. Die Ratenlimits liegen derzeit durchschnittlich bei etwa 100 Anfragen pro Minute über alle Tools hinweg. Ratenlimits können sich ändern.

<Info>
  Wenn Sie den Basic-Plan (Kostenlos) verwenden, können Sie nur Notizen aus den letzten 30
  Tagen abfragen.
</Info>

Wenn Sie eine Meldung erhalten, dass Ihr LLM-Agent nicht auf Ihre Besprechungsnotizen zugreifen oder die Granola-MCP-Tools verwenden kann, versuchen Sie, sich erneut zu authentifizieren. Wenn Granola in Claude verbunden ist, aber **Keine Tools verfügbar** anzeigt, verbinden Sie den Granola-Connector in Claude erneut, um die Verbindung zurückzusetzen:

1. Gehen Sie zu [Claude-Connector-Einstellungen](https://claude.ai/customize/connectors) im Web. Sie müssen dies auf claude.ai tun, auch wenn Sie die Claude-Desktop-App verwenden.
2. Wählen Sie **Granola**.
3. Klicken Sie auf das Drei-Punkte-Menü oben rechts.
4. Wählen Sie **Trennen**.
5. Ohne die Seite zu aktualisieren oder wegzunavigieren, wählen Sie erneut **Verbinden**
   und schließen Sie die Authentifizierung ab.

<Info>
  Wenn Sie einen Claude-Team- oder Enterprise-Plan verwenden, benötigen Sie möglicherweise einen
  Arbeitsbereichsadministrator, der Granola für Sie trennt und erneut verbindet.
</Info>

Wenn Sie diesen Fehler nach Abschluss des OAuth-Anmeldevorgangs sehen, haben Sie sich möglicherweise mit einer anderen E-Mail-Adresse authentifiziert als der, unter der Ihr Granola-Konto registriert ist.

Um zu überprüfen, welche E-Mail Ihr Granola-Konto verwendet, öffnen Sie die Granola-App und gehen Sie zu **Einstellungen** (<kbd>⌘</kbd> + <kbd>,</kbd> auf macOS, <kbd>Strg</kbd> + <kbd>,</kbd> auf Windows). Ihre Kontoe-Mail wird unter Ihrem Profilbild oben links angezeigt.

Stellen Sie beim erneuten Verbinden von MCP sicher, dass Sie sich während des OAuth-Vorgangs mit derselben E-Mail-Adresse anmelden.

Wenn Ihr KI-Tool sagt, dass es keine Notizen finden kann, oder keine Ergebnisse zurückgibt, obwohl Sie wissen, dass Sie Besprechungen haben, ist MCP möglicherweise mit dem falschen Granola-Konto oder dem falschen Arbeitsbereich innerhalb des richtigen Kontos verbunden.

Fragen Sie Ihr KI-Tool: **„Mit welchem Granola-Konto bin ich angemeldet?"** Es verwendet das `get_account_info`-Tool, um die E-Mail und den aktiven Arbeitsbereich zurückzugeben, die derzeit mit MCP verbunden sind. Dann:

• Richtige E-Mail, falscher Workspace: Wechseln Sie den Workspace in der Granola-Desktop-App (klicken Sie unten links auf Ihren Workspace-Namen und wählen Sie den richtigen aus). MCP folgt Ihrem aktiven Workspace, daher verwendet die nächste Abfrage diesen. Sie können Ihr KI-Tool auch bitten, den Workspace für Sie zu wechseln, zum Beispiel: „Wechseln Sie meinen Granola-Workspace zu [Workspace-Name].“

  • Komplett falsche E-Mail: Befolgen Sie die Schritte im Akkordeon Mit dem falschen Konto bei Claude angemeldet unten (oder das Äquivalent für Ihr KI-Tool), um sich zu trennen und mit dem richtigen Konto neu zu verbinden.
  So verbinden Sie Claude MCP mit einem anderen Granola-Konto neu:
  1. Bitten Sie Claude, sich bei Granola abzumelden.
  2. Klicken Sie auf den Link mcp-auth.granola.ai/api/logout, den es Ihnen gibt.
  3. Bitten Sie Claude, sich wieder mit Granola zu verbinden, und melden Sie sich mit der E-Mail-Adresse Ihres Haupt-Granola-Kontos an.

  Der Grund, warum ein normales Trennen/Wiederverbinden dies nicht behebt, ist, dass Ihre bestehende Granola-Sitzung aktiv bleibt und der Anmeldeschritt daher übersprungen wird. Das Abmelden über den Link löscht diese Sitzung, sodass Sie das richtige Konto auswählen können.

Allgemeine FAQ

Nein, Sie können verschiedene Konten für Ihr KI-Tool und Granola verwenden. Sie authentifizieren das Granola-Konto, auf das Ihr KI-Tool Zugriff haben soll. Um zu überprüfen, welche E-Mail-Adresse Ihr Granola-Konto verwendet, öffnen Sie die Granola-App und gehen Sie zu **Einstellungen** (⌘ + , auf macOS, Strg + , auf Windows) – Ihre Konto-E-Mail wird oben links unter Ihrem Profilbild angezeigt. Überprüfen Sie zunächst, welche Zugriffsbereiche für Sie gelten:

* **Basis (kostenlos):** Persönliche Notizen aus den letzten 30 Tagen.
* **Business:** Persönliche Notizen und öffentliche Notizen.
* **Enterprise:** Workspace-Administratoren konfigurieren, welche Bereiche für Mitglieder verfügbar sind.

Der Zugriff auf persönliche Notizen umfasst nicht jede private Notiz im Workspace. Die Notiz muss Ihnen gehören, direkt mit Ihnen geteilt oder in einem privaten Ordner sein, der mit Ihnen geteilt wurde. Der Zugriff auf öffentliche Notizen umfasst Notizen, die für alle im Workspace sichtbar sind, einschließlich Notizen im Team-Bereich.

MCP gibt außerdem nur Notizen zurück, die zum aktiven Workspace gehören. Wenn eine Notiz in einem anderen Granola-Workspace erstellt wurde, gibt MCP sie nicht aus Ihrem aktuellen Workspace zurück, selbst wenn Sie sie in Granola sehen können.

Bestätigen Sie außerdem, dass MCP mit dem richtigen Konto und dem aktiven Workspace verbunden ist, indem Sie Ihr KI-Tool fragen: **„Mit welchem Granola-Konto bin ich angemeldet?“**

Dies sollte sofort geschehen, und Sie haben bei Ihrer nächsten Abfrage Zugriff auf zusätzliche Tools und erhöhte Ratenlimits. Für eine Standard-Browser-OAuth-Verbindung: nein. Granola MCP verwendet Dynamic Client Registration (DCR), was bedeutet, dass Anmeldeinformationen automatisch verwaltet werden. Sie müssen keine Client-ID oder kein Client-Secret generieren oder eingeben.

Wenn Sie eine Drittanbieterplattform (wie Composio) verwenden, die Felder für Client-ID und Client-Secret anzeigt, lassen Sie diese leer – die Plattform registriert sich beim Verbinden automatisch bei Granola.

Die EMA-Einrichtung ist anders. Ihr Identitätsanbieter fragt möglicherweise nach einer **Client-ID bei der Ressource**, wenn Sie die verwaltete Verbindung erstellen. Geben Sie die URL des Client-ID-Metadatendokuments des MCP-Clients ein. Wenn Sie einen vorhandenen MCP-Client wie Claude verwenden, verwenden Sie die von diesem Client bereitgestellte URL; Sie müssen keine eigene erstellen oder ein Client-Secret eingeben.

Wenn Sie Ihren eigenen vertraulichen MCP-Client erstellen, erstellen und hosten Sie dessen Client-ID-Metadatendokument. Die URL des Dokuments ist die Client-ID, und der Client authentifiziert sich mit seinem privaten Schlüssel und nicht mit einem von Granola ausgestellten Client-Secret. Siehe [Wenn Ihr Unternehmen einen eigenen MCP-Client erstellt](#if-your-company-builds-its-own-mcp-client).

Ja – jedes Tool, das die [MCP-Client-Spezifikation](https://modelcontextprotocol.io/) mit Streamable-HTTP-Transport implementiert, kann eine Verbindung zu Granola MCP herstellen. Ihr Tool kann Browser-OAuth oder EMA verwenden, wenn es die Erweiterung unterstützt und Ihre Organisation einen kompatiblen IdP konfiguriert hat. Siehe die Abschnitte „Andere KI-Tools“ und [Enterprise-Managed Authorization](#enterprise-managed-authorization) oben.

Wenn Sie eine benutzerdefinierte Integration erstellen und Hilfe benötigen, wenden Sie sich an [hey@granola.so](mailto:hey@granola.so).

Enterprise-FAQ

Ja. Enterprise-Administratoren können den Notizzugriff konfigurieren, der Workspace-Mitgliedern zur Verfügung steht:

1. Gehen Sie zu **Einstellungen → Workspace → Allgemein**.
2. Finden Sie **MCP-Zugriff** unter **Apps & Connectors**.
3. Klicken Sie auf **Verwalten**.
4. Aktivieren Sie **Persönliche Notizen**, **Öffentliche Notizen**, beide oder keines.

Um zu verhindern, dass KI-Tools Besprechungstranskripte lesen, deaktivieren Sie **Besprechungstranskripte** im selben Dialog. Dies gilt für jedes Meeting in Ihrem Workspace, für alle, die darauf zugreifen können, einschließlich Administratoren und Personen, mit denen eine Notiz geteilt wird. Notizen und Zusammenfassungen bleiben verfügbar. Es ist standardmäßig aktiviert.

Der Zugriff hängt von der aktuellen MCP-Konfiguration des Workspace ab. Wenn keiner der Bereiche aktiviert ist, haben Mitglieder keinen MCP-Zugriff, bis ein Administrator persönliche Notizen, öffentliche Notizen oder beide aktiviert. Die Steuerelemente befinden sich unter **Einstellungen → Workspace → Allgemein → Apps & Connectors → MCP-Zugriff**. Alle Enterprise-Workspace-Mitglieder können die Einstellung sehen, aber nur Administratoren können sie ändern. Wenn Sie einen anderen Bereich benötigen, fragen Sie Ihren Workspace-Administrator. Die Steuerelemente für den Notizzugriff tun das nicht. Sie bestimmen, worauf Nicht-Administrator-Workspace-Mitglieder über MCP zugreifen können. Enterprise-Administratoren können über MCP sowohl auf persönliche Notizen als auch auf öffentliche Notizen zugreifen.

Der Schalter **Besprechungstranskripte** gilt für alle, einschließlich Administratoren.

Diese Dokumentation wird auf Mintlify erstellt und gehostet, einer Plattform für Entwicklerdokumentation.