PlugsightDocs

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.

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.

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 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; leave it out when the MCP server has only one.

Tool What it does Kind
forms_get Google Form details Read
forms_responses Google Form responses Read
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:

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:

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:

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