> For the complete documentation index, see [llms.txt](https://docs.natoma.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.natoma.ai/apps/google-forms.md).

# Google Forms (Natoma)

{% hint style="warning" %}
**Early Access** — This server is currently in early access. Features and configuration may change.
{% endhint %}

**Type:** Natoma Hosted

**Source Type:** Remote URL

**Description:** This connection enables AI-powered form creation, question management, and response retrieval through Natoma. Available tools are a subset of the Google Workspace Server.

***

## Setup

### Step 1: Enable the Google Forms API

1. Go to the [Google Cloud Console](https://console.cloud.google.com/).
2. Make sure your target project is selected in the top project dropdown.
3. In the left sidebar, navigate to **APIs & Services > Library**.
4. Search for **Google Forms API** and click on it.
5. Click **Enable**.

You can also enable it directly: [Google Forms API](https://console.cloud.google.com/flows/enableapi?apiid=forms.googleapis.com)

{% hint style="info" %}
Some Forms operations — such as listing forms stored in Drive — also require the Google Drive API. You may enable it alongside Forms: [Google Drive API](https://console.cloud.google.com/flows/enableapi?apiid=drive.googleapis.com)
{% endhint %}

### Step 2: Configure the OAuth Consent Screen

1. In the Google Cloud Console, go to **Google Auth Platform > Branding** (or search "OAuth consent screen" in the top search bar).
2. If the Auth Platform isn't set up yet, click **Get Started** and fill in the following:
   * **App name:** Google Forms MCP Server
   * **User support email:** your email address — click **Next**
   * **Audience:** Select **Internal** — click **Next**
   * **Contact email:** your email address
3. Agree to the Google API Services User Data Policy, then click **Continue > Create**.
4. Click **Data Access** in the left menu, then click **Add or Remove Scopes**.
5. In the panel that appears, scroll down to **Manually add scopes** and paste in all three scopes (one per line):

   ```
   https://www.googleapis.com/auth/forms.body.readonly
   https://www.googleapis.com/auth/forms.body
   https://www.googleapis.com/auth/forms.responses.readonly
   ```
6. Click **Add to Table**, then **Update**, then **Save**.

{% hint style="info" %}
If your use case requires listing forms from Drive, also add `https://www.googleapis.com/auth/drive.readonly`.
{% endhint %}

### Step 3: Create an OAuth 2.0 Client ID

1. Go to **Google Auth Platform > Clients > Create Client** and select **Web application** as the application type.
2. Name the application.
3. In the **Authorized redirect URIs** section, click **+ Add URL** and enter:

{% hint style="warning" %}
Use exactly this redirect URI — Natoma will not complete the OAuth flow if it doesn't match.
{% endhint %}

```
https://api.natoma.app/mcp/server/callback
```

4. Click **Create** and copy the **Client ID** and **Client Secret**.

### Step 4: Configure the Connector in Natoma

1. Log in to your Natoma workspace as an Admin and navigate to **Apps**, then search for **Google Forms (Natoma)**.
2. Click **+** > **Allow Personal Connections**.
3. In the connector configuration dialog, enter the following:

| Field               | Value                                       |
| ------------------- | ------------------------------------------- |
| Server name         | Google Forms MCP (or any descriptive label) |
| OAuth Client ID     | The Client ID from Step 3                   |
| OAuth Client Secret | The Client Secret from Step 3               |

4. Save the connector. Natoma will initiate an OAuth consent flow to authorize access to your Google Forms.