# Google Forms tools

> The Google Forms tools in the developer API, with every argument: read a form's questions, its responses and totals.

**Needs:** A Google Forms connection. 3 tools, all read-only.

> [!IMPORTANT]
> Google is still reviewing the permission this connector needs. Until it approves it, Plugsight offers Google Forms to Plugsight admins only, so for most people it isn't in the **Connector catalog** yet and these tools don't appear. See [Google Forms](https://docs.plugsight.app/connectors/google-forms.md).

These tools appear in `GET /v1/tools` only when the API key's MCP server includes a connection of this kind. Call each one with `POST /v1/tools/\<name>`, sending its arguments as a JSON object. See [Calling tools](https://docs.plugsight.app/developers/calling-tools.md) for the request and response format.

Open a form by its edit link (from Google Forms, not the link people fill in) or its id. The optional `account` argument takes a Google Forms connection `id` from [`list_accounts`](https://docs.plugsight.app/developers/accounts-tools.md); leave it out when the MCP server has only one.

| Tool | What it does | Kind |
| --- | --- | --- |
| [`forms_get`](#forms_get) | Google Form details | Read |
| [`forms_responses`](#forms_responses) | Google Form responses | Read |
| [`forms_summary`](#forms_summary) | Summarise Google Form responses | Read |

Every tool here only reads: none of them changes anything in Google Forms, so none needs `confirm`.

The example requests fill in only the required arguments, with placeholder values.

## forms_get

**Google Form details** · Read

A Google Form's title, description, fill-in link and every question with its type and options.

| Argument | Type | Required | What it is |
| --- | --- | --- | --- |
| `form` | string | Yes | The form's edit link (from Google Forms, not the fill-in link) or its id |
| `account` | string | No | Google Forms connection id from list_accounts (optional when there's only one) |

Example request:

```bash
curl -X POST https://app.plugsight.app/v1/tools/forms_get \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"form": "…"}'
```

## forms_responses

**Google Form responses** · Read

A form's responses as a table, newest first: when it was submitted, the respondent's email when the form collects it, and one column per question.

| Argument | Type | Required | What it is |
| --- | --- | --- | --- |
| `form` | string | Yes | The form's edit link (from Google Forms, not the fill-in link) or its id |
| `since` | string | No | Only responses submitted on or after this date, YYYY-MM-DD |
| `limit` | integer | No | Most responses to return. From 1 to 5,000. Default `200`. |
| `account` | string | No | Google Forms connection id from list_accounts (optional when there's only one) |

Example request:

```bash
curl -X POST https://app.plugsight.app/v1/tools/forms_responses \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"form": "…"}'
```

## forms_summary

**Summarise Google Form responses** · Read

Totals per question: how many chose each option of choice, scale and rating questions, and how many answered the others. Use forms_responses to read the written answers.

| Argument | Type | Required | What it is |
| --- | --- | --- | --- |
| `form` | string | Yes | The form's edit link (from Google Forms, not the fill-in link) or its id |
| `since` | string | No | Only responses submitted on or after this date, YYYY-MM-DD |
| `account` | string | No | Google Forms connection id from list_accounts (optional when there's only one) |

Example request:

```bash
curl -X POST https://app.plugsight.app/v1/tools/forms_summary \
  -H "Authorization: Bearer $PLUGSIGHT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"form": "…"}'
```

## Related articles

- [Google Forms](https://docs.plugsight.app/connectors/google-forms.md)
- [Calling tools](https://docs.plugsight.app/developers/calling-tools.md)
- [Errors](https://docs.plugsight.app/developers/errors.md)
- [Accounts tools](https://docs.plugsight.app/developers/accounts-tools.md)

---

Web version: https://docs.plugsight.app/developers/forms-tools
