mcp-granola

Ein MCP (Model Context Protocol)-Server, der KI-Agenten Zugriff auf Ihre Granola-Besprechungsnotizen gibt. Durchsuchen Sie Notizen, rufen Sie vollständige Inhalte mit Transkripten ab und blättern Sie durch Ihren Besprechungsverlauf.

Funktionen

• Notizen auflisten mit Datumsfilterung und cursorbasierter Paginierung

• Vollständigen Notizinhalt abrufen inklusive KI-Zusammenfassungen und Besprechungstranskripten

• Notizen durchsuchen nach Titel- oder Zusammenfassungs-Schlüsselwörtern

• Funktioniert mit Claude Code, Gemini CLI und jedem MCP-kompatiblen Client

• Keine externen Abhängigkeiten außer dem MCP SDK

Schnellstart

1. Installieren

npm install @devli13/mcp-granola

Oder klonen und lokal installieren:

git clone https://github.com/devli13/mcp-granola.git
cd mcp-granola
npm install

2. Granola-API-Schlüssel abrufen

1. Öffnen Sie die Granola-Desktop-App

2. Gehen Sie zu Settings > API

3. Klicken Sie auf Create new key

4. Kopieren Sie den Schlüssel (beginnt mit grn_)

3. Konfigurieren

Fügen Sie dies zu Ihrer .mcp.json (Claude Code) oder .gemini/settings.json (Gemini CLI) hinzu:

{
  "mcpServers": {
    "granola": {
      "command": "npx",
      "args": ["-y", "@devli13/mcp-granola"],
      "env": {
        "GRANOLA_API_KEY": "grn_your_api_key_here"
      }
    }
  }
}

Oder führen Sie es direkt aus:

GRANOLA_API_KEY=grn_your_key node server.js

Konfiguration

Tools

Beispiel: aktuelle Notizen auflisten

{
  "name": "list_notes",
  "arguments": {
    "limit": 5,
    "created_after": "2025-01-01T00:00:00Z"
  }
}

Beispiel: eine Notiz mit Transkript abrufen

{
  "name": "get_note",
  "arguments": {
    "id": "not_abc123def456",
    "include_transcript": true
  }
}

Einschränkungen

• Die Granola-API befindet sich in der Beta-Phase – Endpunkte und Antwortformate können sich ändern.

• Persönliche API-Schlüssel greifen nur auf Notizen zu, die Ihnen gehören oder direkt für Sie freigegeben wurden.

• search_notes führt einen clientseitigen Teilstring-Abgleich über die 200 neuesten Notizen durch. Es ist keine Volltext-Suchmaschine. Verwenden Sie bei großen Notizvolumina stattdessen list_notes mit Datumsfiltern.

• Die API gibt nur Notizen mit generierten KI-Zusammenfassungen und Transkripten zurück. Notizen, die noch verarbeitet werden, erscheinen nicht.

Ratenbegrenzungen

Granola erzwingt Ratenbegrenzungen pro Arbeitsbereich:

Mitwirken

Problemberichte und Pull Requests sind willkommen! Bitte eröffnen Sie zuerst ein Issue, um wesentliche Änderungen zu besprechen.

Lizenz

MIT