Skip to main content

​
At a glance

  • Availability: Experimental (how to enable).
  • Auth: OAuth 2.0.
  • Connection: A user authorizes the connection in the provider’s consent screen.
  • Scopes: https://www.googleapis.com/auth/forms.body.readonly, https://www.googleapis.com/auth/forms.responses.readonly.
  • Optional scopes: https://www.googleapis.com/auth/forms.body.
  • Docs: https://developers.google.com/workspace/forms/api/reference/rest

​
Credentials

Set these per environment. See Connect an integration. With a managed OAuth app, Connect works without these variables; set them to use your own OAuth app instead.
VariableRequiredDescription
GOOGLE_CLIENT_IDYesGoogle OAuth Client ID Docs.
GOOGLE_CLIENT_SECRETYesGoogle OAuth Client Secret Docs.

​
Setup

  1. Create a Google Cloud project: Go to https://console.cloud.google.com, create (or select) a project. A free Google account is enough for testing.
  2. Enable the Google Forms API: Open https://console.cloud.google.com/apis/library/forms.googleapis.com and click Enable for your project.
  3. Configure the OAuth consent screen: Under APIs & Services > OAuth consent screen, configure the app and add the Forms scopes (forms.body.readonly, forms.responses.readonly, and forms.body if you need write access). Add your account as a test user while the app is in testing mode.
  4. Create OAuth credentials: Under APIs & Services > Credentials, create an OAuth client ID of type Web application and add your callback URL as an authorized redirect URI. Set GOOGLE_CLIENT_ID and GOOGLE_CLIENT_SECRET from the generated credentials.
  • The Forms API can read responses but cannot submit them; responses are only created by people filling out the form.
  • Create Form only honors info.title and info.documentTitle; add questions and settings afterwards with Batch Update Form.
  • Creating or editing forms requires the https://www.googleapis.com/auth/forms.body scope (listed under optional scopes).
Provider API reference: https://developers.google.com/workspace/forms/api/reference/rest

​
Tools

ToolAccessDescription
Get FormReadGet a form’s metadata, settings, and items (questions) including the question IDs needed to interpret responses
List Form ResponsesReadList submitted responses for a form, with answers keyed by question ID
Get Form ResponseReadGet a single response submitted to a form
Create FormWriteCreate a new form with a title; add questions afterwards with Batch Update Form
Set Publish SettingsWritePublish or unpublish a form and toggle whether it accepts responses, e.g. to open a survey after building it or close it when done (requires the forms.body scope)
Batch Update FormWriteApply a batch of updates to a form, such as adding questions, updating form info, or changing settings

​
Example prompts

  • Get the responses for my Google Form and summarize the answers per question, highlighting common themes.
  • Create a new Google Form for customer feedback and add a rating question plus an open-text comments question.
  • Show me the responses submitted to my Google Form in the last 7 days.