Skip to main content

​
What can you do with it?

Google Forms allows you to create and manage online forms programmatically. You can create new forms, add various types of questions (text, multiple choice, checkboxes, scales, dates), update existing forms, retrieve form responses, set up webhooks for real-time notifications, and manage form permissions. This integration is perfect for survey automation, feedback collection, and dynamic form generation. Note that listing all forms requires the Google Drive integration.

​
How to use it?

​
Basic Command Structure

/your-Google-Forms-connection [action] [required-parameters] [optional-parameters]

​
Parameters

Required:
  • action - The operation to perform on forms

​
Tools

​
Get Form

Retrieve form details, structure, and questions Parameters:
  • form-id (required) - The ID of the form
Example: 
/your-Google-Forms-connection
action: get-form
form-id: 1ABC123def456
Response: 
{
  "formId": "1ABC123def456",
  "info": {
    "title": "Sample Form",
    "description": "This is a sample form"
  },
  "items": [
    {
      "itemId": "item123",
      "title": "What is your name?",
      "questionItem": {
        "question": {
          "textQuestion": {}
        }
      }
    }
  ]
}

​
Create Form

Create a new form with title and description Parameters:
  • title (required) - Title for the new form
  • description (optional) - Description of the form
Example: 
/your-Google-Forms-connection
action: create-form
title: Customer Feedback Survey
description: Please share your experience with our service
Response: 
{
  "formId": "1XYZ789abc123",
  "info": {
    "title": "Customer Feedback Survey",
    "description": "Please share your experience with our service"
  },
  "responderUri": "https://docs.google.com/forms/d/1XYZ789abc123/viewform"
}

​
Update Form

Update form title, description or settings Parameters:
  • form-id (required) - The ID of the form to update
  • title (optional) - New title for the form
  • description (optional) - New description for the form
Example: 
/your-Google-Forms-connection
action: update-form
form-id: 1ABC123def456
title: Updated Customer Survey
description: New and improved feedback form
Response: 
{
  "formId": "1ABC123def456",
  "info": {
    "title": "Updated Customer Survey",
    "description": "New and improved feedback form"
  }
}

​
Add Text Question

Add a text question to a form Parameters:
  • form-id (required) - The ID of the form
  • question (required) - The question text
  • required (optional) - Whether the question is required (default: false)
  • position (optional) - Position index for the question
Example: 
/your-Google-Forms-connection
action: add-text-question
form-id: 1ABC123def456
question: What is your email address?
required: true
position: 0
Response: 
{
  "itemId": "item456"
}

​
Add Multiple Choice Question

Add a multiple choice question (radio, checkbox, or dropdown) Parameters:
  • form-id (required) - The ID of the form
  • question (required) - The question text
  • type (required) - Question type: RADIO, CHECKBOX, or DROP_DOWN
  • options (required) - Comma-separated list of options
  • required (optional) - Whether the question is required
  • position (optional) - Position index for the question
Example: 
/your-Google-Forms-connection
action: add-choice-question
form-id: 1ABC123def456
question: Choose your favorite color
type: RADIO
options: Red, Blue, Green, Yellow
required: true
position: 1
Response: 
{
  "itemId": "item789"
}

​
Add Scale Question

Add a linear scale question Parameters:
  • form-id (required) - The ID of the form
  • question (required) - The question text
  • low (required) - Lowest value on scale
  • high (required) - Highest value on scale
  • low-label (optional) - Label for low end
  • high-label (optional) - Label for high end
  • position (optional) - Position index
Example: 
/your-Google-Forms-connection
action: add-scale-question
form-id: 1ABC123def456
question: How likely are you to recommend us?
low: 1
high: 10
low-label: Not at all likely
high-label: Extremely likely
Response: 
{
  "itemId": "item321"
}

​
Update Question

Update an existing question Parameters:
  • form-id (required) - The ID of the form
  • item-id (required) - The ID of the question to update
  • question (required) - Updated question text
  • options (optional) - Updated options for choice questions
Example: 
/your-Google-Forms-connection
action: update-question
form-id: 1ABC123def456
item-id: item789
question: Select your preferred colors
options: Red, Blue, Green, Yellow, Purple
Response: 
{
  "itemId": "item789"
}

​
Delete Question

Remove a question from a form Parameters:
  • form-id (required) - The ID of the form
  • item-id (required) - The ID of the question to delete
Example: 
/your-Google-Forms-connection
action: delete-question
form-id: 1ABC123def456
item-id: item789
Response: 
{
  "status": "deleted"
}

​
Get Responses

Retrieve all form responses Parameters:
  • form-id (required) - The ID of the form
Example: 
/your-Google-Forms-connection
action: get-responses
form-id: 1ABC123def456
Response: 
{
  "responses": [
    {
      "responseId": "response123",
      "createTime": "2023-06-15T10:30:45.123Z",
      "answers": {
        "item123": {
          "textAnswers": {
            "answers": [
              {
                "value": "John Doe"
              }
            ]
          }
        },
        "item789": {
          "textAnswers": {
            "answers": [
              {
                "value": "Blue"
              }
            ]
          }
        }
      }
    }
  ]
}

​
Set Up Webhook

Set up a webhook to receive form submissions Parameters:
  • form-id (required) - The ID of the form
  • webhook-url (required) - URL to receive notifications
Example: 
/your-Google-Forms-connection
action: setup-webhook
form-id: 1ABC123def456
webhook-url: https://your-webhook-endpoint.com/callback
Response: 
{
  "id": "watch123",
  "expiryTime": "2023-07-15T10:30:45.123Z"
}

​
Notes

Form IDs and Item IDs are required for most operations and must be obtained from existing forms. To list all forms, use the Google Drive integration. Question types include text, paragraph text, multiple choice (radio/checkbox/dropdown), linear scale, date, time, and file upload. Form responses are returned with answers mapped to their corresponding item IDs.
⌘I