Google Slides MCP Server

Dieser Prozess ist ein MCP-Server für die Google Slides API. Ein Host kommuniziert über stdio mit ihm. Beim ersten Start wird ein Browser geöffnet. Sie fügen eine Desktop-Client-ID und ein Client-Geheimnis ein. Danach folgt die Google-Zustimmung. Spätere Starts lesen den Token-Speicher.

Voraussetzungen

• Node.js 20 oder neuer

• Ein Google Cloud-Projekt mit aktivierter Google Slides API

• Eine OAuth-Desktop-Client-ID und ein Client-Geheimnis

Sie benötigen kein Refresh-Token. Sie benötigen keine Prozess-Umgebungsvariablen.

Related MCP server: MCP Google Sheets Server

Claude Code

1. Erstellen Sie einen Desktop-OAuth-Client. Verwenden Sie die Schritte der Google Auth-Plattform unten.

2. Führen Sie in Claude Code aus:

/plugin marketplace add matteoantoci/claude-plugins
/plugin install google-slides-mcp@matteoantoci-plugins

3. Führen Sie /reload-plugins aus, wenn Claude Sie darum bittet.

4. Beim ersten Start wird ein Browser geöffnet. Fügen Sie die Client-ID und das Client-Geheimnis ein. Schließen Sie die Google-Zustimmung ab.

Spätere Sitzungen lesen den Token-Speicher. Kein Host-JSON. Keine Umgebungsvariablen.

Andere Hosts

1. Klonen Sie dieses Repository.

2. Führen Sie npm install aus.

3. Führen Sie npm run build aus.

4. Erstellen Sie einen Desktop-OAuth-Client in der Google Cloud Console:

   • Öffnen Sie die Google Auth-Plattform.

   • Wenn die Seite angibt, dass die Plattform nicht konfiguriert ist, klicken Sie auf Loslegen.

   • App-Name: Google Slides MCP. E-Mail für Benutzersupport: Ihre Adresse.

   • Zielgruppe: Extern.

   • Kontakt-E-Mail: Ihre Adresse. Stimmen Sie der Richtlinie zu. Klicken Sie auf Erstellen.

   • Öffnen Sie Zielgruppe. Fügen Sie Ihre Gmail-Adresse als Testbenutzer hinzu.

   • Öffnen Sie Datenzugriff. Fügen Sie https://www.googleapis.com/auth/presentations und https://www.googleapis.com/auth/drive.readonly hinzu. Speichern Sie.

   • Öffnen Sie Clients. Klicken Sie auf Client erstellen. Anwendungstyp: Desktop-App. Name: Google Slides MCP Desktop. Klicken Sie auf Erstellen.

   • Kopieren Sie die Client-ID und das Client-Geheimnis.

5. Führen Sie npm run start aus. Fügen Sie die Client-ID und das Client-Geheimnis ein. Schließen Sie die Google-Zustimmung ab. Beenden Sie dann den Prozess.

6. Richten Sie den Host auf node /path/to/google-slides-mcp/build/index.js aus. Setzen Sie keine Umgebungsvariablen.

Beispiel-Host-Konfiguration:

"google-slides-mcp": {
  "transportType": "stdio",
  "command": "node",
  "args": [
    "/path/to/google-slides-mcp/build/index.js"
  ]
}

Ersetzen Sie den Pfad durch das kompilierte build/index.js auf Ihrem Rechner.

Erster Start

Der Prozess öffnet eine Loopback-Seite.

• Wenn der Speicher keine Client-ID oder kein Client-Geheimnis enthält, fügen Sie diese beiden Werte ein.

• Fahren Sie mit der Google-Zustimmung fort.

• Schließen Sie die Erfolgsseite.

Der Prozess schreibt die Google-Anmeldedaten in den Token-Speicher. Er versucht zuerst den OS-Schlüsselbund. Er verwendet ~/.config/google-slides-mcp/credential.json, wenn der Schlüsselbund nicht verfügbar ist. Der Dateimodus ist 0600.

Spätere Starts verwenden den Speicher. Kein Browser.

GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET und GOOGLE_REFRESH_TOKEN können ein Feld überschreiben. Sie sind nie erforderlich. Wenn die Umgebung ein fehlendes Feld liefert, schreibt der Prozess die zusammengeführten Anmeldedaten in den Speicher.

Ohne Host ausführen

npm run start

Der Prozess lauscht auf stdio. Stderr gibt Google Slides MCP server running and connected via stdio. aus.

Verfügbare Tools

• create_presentation: Erstellt eine neue Google Slides-Präsentation.

  • Eingabe:

    • title (string, erforderlich): Der Titel für die neue Präsentation.

  • Ausgabe: JSON-Objekt, das die Details der erstellten Präsentation darstellt.

• get_presentation: Ruft Details zu einer vorhandenen Präsentation ab.

  • Eingabe:

    • presentationId (string, erforderlich): Die ID der abzurufenden Präsentation.

    • fields (string, optional): Eine Feldmaske (z. B. "slides,pageSize"), um die zurückgegebenen Daten zu begrenzen.

  • Ausgabe: JSON-Objekt, das die Präsentationsdetails darstellt.

• batch_update_presentation: Wendet eine Reihe von Aktualisierungen auf eine Präsentation an. Dies ist die primäre Methode zum Ändern von Folien (Hinzufügen von Text, Formen, Bildern, Erstellen von Folien usw.).

  • Eingabe:

    • presentationId (string, erforderlich): Die ID der zu aktualisierenden Präsentation.

    • requests (array, erforderlich): Ein Array von Anforderungsobjekten, die die Aktualisierungen definieren. Informationen zur Struktur einzelner Anforderungen finden Sie in der Google Slides API batchUpdate-Dokumentation.

    • writeControl (object, optional): Steuert die Ausführung von Schreibanforderungen (z. B. mithilfe von Revisions-IDs).

  • Ausgabe: JSON-Objekt, das das Ergebnis der Batch-Aktualisierung darstellt.

• get_page: Ruft Details zu einer bestimmten Seite (Folie) innerhalb einer Präsentation ab.

  • Eingabe:

    • presentationId (string, erforderlich): Die ID der abzurufenden Präsentation.

    • pageObjectId (string, erforderlich): Die Objekt-ID der abzurufenden Seite (Folie).

  • Ausgabe: JSON-Objekt, das die Seitendetails darstellt.

• summarize_presentation: Extrahiert und formatiert den gesamten Textinhalt einer Präsentation, um die Zusammenfassung zu erleichtern.

  • Eingabe:

    • presentationId (string, erforderlich): Die ID der zusammenzufassenden Präsentation.

    • include_notes (boolean, optional): Ob Sprechernotizen in die Zusammenfassung aufgenommen werden sollen. Standard ist false.

  • Ausgabe: JSON-Objekt, das Folgendes enthält:

    • title: Der Titel der Präsentation

    • slideCount: Gesamtzahl der Folien

    • lastModified: Revisionsinformationen

    • slides: Array von Folienobjekten, die Folgendes enthalten:

      • slideNumber: Position in der Präsentation

      • slideId: Objekt-ID der Folie

      • content: Der gesamte aus der Folie extrahierte Text

      • notes: Sprechernotizen (falls angefordert und verfügbar)