Google Forms MCP

English | Русский

A1 Google Forms MCP ermöglicht einer KI-App, Google Formulare in einfacher Sprache zu erstellen und zu verwalten. Erstelle eine Umfrage, wähle ihre Fragen, veröffentliche sie, wenn du bereit bist, lies Antworten und nutze Benachrichtigungen für neue Einsendungen.

Es verwendet die Google Forms API mit deinem Google-Konto. Es unterscheidet ein Entwurfsformular von einem veröffentlichten Formular und macht die Grenzen der Forms API deutlich, statt den Eindruck zu erwecken, dass jede Formularaufgabe möglich sei.

• 13 Tools. Untersuche Formularstrukturen und Antworten, erstelle und bearbeite Formulare und Fragen, verwalte die Veröffentlichung und konfiguriere Pub/Sub-Watches.

• Bewusst veröffentlichen. Über die API erstellte Formulare starten unveröffentlicht und können so keine Antworten sammeln, bis du sie veröffentlichst.

• Antworten bleiben erhalten. Die API kann Antworten lesen, aber nicht erstellen oder bearbeiten; der Server hat kein Tool, das Antworten einreicht.

• Minimale Google-Berechtigungen. Es verwendet forms.body und forms.responses.readonly, ohne breiten Drive-Zugriff.

Starte mit einer reinen Lesefrage:

Zeig mir die Antworten von gestern auf dem Kundenfeedback-Formular und fasse die Freitextantworten zusammen.

Server verbinden · Anwendungsfälle ansehen · Technische Dokumentation öffnen

So funktioniert es in einer Minute

Du: Zeig mir die Fragen und Veröffentlichungseinstellungen des Kundenfeedback-Formulars.

Assistent: Zeigt das Formular, seine Elemente, ob es veröffentlicht ist und ob es Antworten akzeptiert. Dabei ändert sich nichts.

Du: Erstelle eine Pflicht-Bewertungsfrage mit einer Skala von 1 bis 5 namens „Wie war deine Erfahrung?“ direkt nach der ersten Frage.

Assistent: Zeigt das Zielformular, die Position und die vorgeschlagene Frage und fragt dann, bevor er sie hinzufügt, um Bestätigung.

Du: Bestätige.

Assistent: Fügt die Frage dem Formular hinzu. Er veröffentlicht oder schließt das Formular nicht, wenn du es nicht separat verlangst.

Related MCP server: Google Workspace MCP Server

Inhaltsverzeichnis

• Schnellstart

• Was kannst du es bitten zu tun

• Wie sich ein Formular ändert

• Was sich ändern kann

• Zugriff erhalten

• Konfiguration

• Daten, Grenzen und Hintergrundarbeiten

• Technische Dokumentation

• Unterstützung

Schnellstart

Du benötigst Node.js 20+, ein Google-Konto und OAuth-Anmeldedaten aus einem Google-Cloud-Projekt, in dem die Google Forms API aktiviert ist.

1. Bereite Google-OAuth-Zugang vor.

2. Füge den Server in deine KI-App ein.

3. Stelle die obige reine Lesefrage.

In der App: Öffne Settings → Developer → Plugins → MCP servers, wähle Add server und füge dann npx -y mcp-google-forms@latest zusammen mit GOOGLE_FORMS_CLIENT_ID, GOOGLE_FORMS_CLIENT_SECRET und GOOGLE_FORMS_REFRESH_TOKEN hinzu.

Von der Kommandozeile:

codex mcp add google-forms \
  --env GOOGLE_FORMS_CLIENT_ID=your_client_id \
  --env GOOGLE_FORMS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_FORMS_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-forms@latest

codex mcp list

Codex-MCP-Dokumentation

claude mcp add \
  --env GOOGLE_FORMS_CLIENT_ID=your_client_id \
  --env GOOGLE_FORMS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_FORMS_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-forms \
  -- npx -y mcp-google-forms@latest

claude mcp list

Claude Code MCP-Dokumentation

Öffne Settings → Developer → Edit Config und füge Folgendes hinzu:

{
  "mcpServers": {
    "google-forms": {
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"],
      "env": {
        "GOOGLE_FORMS_CLIENT_ID": "your_client_id",
        "GOOGLE_FORMS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_FORMS_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Wenn Edit Config nicht verfügbar ist, bearbeite ~/Library/Application Support/Claude/claude_desktop_config.json aufmacOS oder %APPDATA%\Claude\claude_desktop_config.json unter Windows.

Claude-Desktop-MCP-Dokumentation

Füge Folgendes zu ~/.cursor/mcp.json auf macOS/Linux oder %USERPROFILE%\.cursor\mcp.json unter Windows hinzu:

{
  "mcpServers": {
    "google-forms": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"],
      "env": {
        "GOOGLE_FORMS_CLIENT_ID": "your_client_id",
        "GOOGLE_FORMS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_FORMS_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Cursor-MCP-Dokumentation

Führe MCP: Open User Configuration aus und füge Folgendes hinzu:

{
  "servers": {
    "google-forms": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"],
      "env": {
        "GOOGLE_FORMS_CLIENT_ID": "${input:forms_client_id}",
        "GOOGLE_FORMS_CLIENT_SECRET": "${input:forms_client_secret}",
        "GOOGLE_FORMS_REFRESH_TOKEN": "${input:forms_refresh_token}"
      }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "forms_client_id", "description": "Google OAuth client ID" },
    { "type": "promptString", "id": "forms_client_secret", "description": "Google OAuth client secret", "password": true },
    { "type": "promptString", "id": "forms_refresh_token", "description": "Google OAuth refresh token", "password": true }
  ]
}

Überprüfe es mit MCP: List Servers.

VS-Code-MCP-Dokumentation

Was du es bitten kannst zu tun

Eine Umfrage und Antworten ansehen

• Zeige mir die Fragen, Antworteneinstellungen und den Teilnehmerlink dieses Formulars.

• Wie viele Antworten sind seit Montag eingegangen? Fasse das Feedback der Freitextantworten zusammen.

• Zeige mir eine einzelne Antwort anhand ihrer ID.

Formulare erstellen und verbessern

• Erstelle ein RSVP-Formular mit Name, Essenspräferenz und Anreisedatum.

• Füge eine Pflicht-Bewertungs-, Dropdown-, Datums-, Zeit-, Auswahl- oder Textfrage hinzu.

• Verschiebe eine Frage oder aktualisiere Titel, Beschreibung, Quizmodus oder E-Mail-Sammlung.

Publish und Benachrichtigungen verknüpfen

• Veröffentliche ein vorbereitetes Formular und zeige seine Teilnehmer-URL.

• Beende die Annahme neuer Antworten, ohne das Formular zu löschen.

• Erstelle, erneuere oder entferne einen Cloud Pub/Sub-Watch für neue Einsendungen.

Wie sich ein Formular ändert

1. create_form erstellt ein Formular, das standardmäßig unveröffentlicht beginnt.

2. Fragen sind Formularelemente, die über ihre Position im Formular identifiziert werden.

3. Veröffentlichen macht ein Formular für Teilnehmer zugänglich. Das Schließen der Antwortsammlung lässt es veröffentlicht, stoppt aber neue Einsendungen.

4. Antworten sind ein damit separater, reiner Lesedatensatz. Die API kann die Antwort eines Teilnehmers nicht einreichen, bearbeiten oder löschen.

Dateiupload-Fragen können über die Forms API nicht erstellt werden, obwohl vorhandene Dateiupload-Elemente gelesen werden können. Eine alte Formulare, die vor dem Veröffentlichungsmodell von Google erstellt wurden, unterstützen möglicherweise keine Veröffentlichungseinstellungen.

Was sich ändern kann

Der KI-Client steuert die Auftragsbestätigungen. Der Server kennzeichnet Lese-, Schreib- und destructive Werkzeuge, damit der Client eine Überprüfung von einer echten Änderung unterscheiden kann.

Zugang erhalten

Google Forms erfordert OAuth 2.0; ein API-Schlüssel reicht nicht.

1. Erstelle oder wähle ein Google-Cloud-Projekt und aktiviere Google Forms API.

2. Konfigure den OAuth-Zustimmungsbildschirm und erstelle einen OAuth-Client für Desktop-App.

3. Autorisier das Google-Konto, das die Formulare besitzt oder bearbeiten darf. Der OAuth 2.0 Playground -OAuth-2.0-Playground kann den Refresh Token erhalten, wenn Use your own OAuth credentials aktiviert ist.

4. Frag beide Bereiche an:

   https://www.googleapis.com/auth/forms.body
   https://www.googleapis.com/auth/forms.responses.readonly

OAuth-Refresh-Tokens im Testmodus können nach sieben Tagen verfallen. Veröffentliche die OAuth-App oder verwende eine interne App in einer Workspace-Domain, wenn du einen langlebigen Zugriff benötigst. Behandle Client-Secret und Refresh-Token wie Passwörter.

Konfiguration

* Gib entweder das OAuth-Trio oder ein Zugriffstoken an.

Daten, Grenzen und Hintergrundarbeit

• Anfragen gehen an Google Forms. Der Server erneuert Google-OAuth-Tokens und ruft die Forms API auf. Seine anonyme Fehlertelemetrie enthält eine Installations-ID, Paketversion, KI-Client, Plattformversion und Tool-Namen – nie OAuth-Tokens, Formulardaten, Tool-Argumente oder Prompts. Set ASKADS_TELEMETRY=0, um zu deaktivieren.

• Google wendet Pro-Minuten-Kontingente an. Die dokumentierten Grenzwerte sind 1250 Lesevorgänge pro Projekt, 5000 list_responses-Aufrufe and 100 changes. Er nach 429 verwendet der Server Backoff; Lesevorgänge werden bei Netzwerk- und 5xx-Fehlern erneut versucht, während Schreibvorgänge nach einem unsicheren Fehler nicht wiederholt werden.

• Es gibt keinen Hintergrund-Polling. Der Server läuft nur, wenn er angeboten wird. Pub/Sub-Watches können Benachrichtigungen über neue Antworten an deine Infrastruktur senden; zusätzlich kann die KI-App geplante Aufgaben unterstützen, um regelmäßig Antworten prüft.

Technische Dokumentation

• MCP-Fähigkeitenkatalog – aufgabenorientierte Seiten für jedes Tool.

• Alle Tools und Eingaben

• Entwicklungsdokumentation

• Veröffentlichungsdokumentation

• Google Forms API-Referenz

Unterstützung

Hast du einen Fehle besteht A. Erstellen Sie einen Fehler oder ein fehlendes Szenario gefunden? Erstelle ein Issue oder schreibe inTelegram.