Google Forms MCP Server

An MCP server for managing Google Forms and form responses, integrating seamlessly with AI assistants using the Model Context Protocol.

Features

• List Forms: Search and list Google Forms from Drive with optional title filter and pagination.
• Get Form: Retrieve metadata, items, and settings for a specific form.
• Create Form: Create a new, empty Google Form by title.
• Batch Update: Add, move, or delete items and update form info via the Forms batchUpdate API.
• List Responses: Page through responses for a form, with optional time filter.
• Get Response: Fetch a single response by responseId.
• Manage Watches: Create, list, and delete Pub/Sub watches for SCHEMA or RESPONSES events.

Installation

Prerequisites

• Python 3.9 or higher.
• A Google Cloud Project with the Google Forms API and Google Drive API enabled.
• OAuth2 credentials (Client ID and Client Secret).
• OAuth scopes:
  • https://www.googleapis.com/auth/forms.body
  • https://www.googleapis.com/auth/forms.responses.readonly
  • https://www.googleapis.com/auth/drive.readonly

Configuration

Add the following to your MCP host configuration (e.g., mcp-config.json):

{
  "mcpServers": {
    "barie-google-forms-mcp": {
      "command": "uvx",
      "args": [
        "barie-google-forms-mcp",
        "--access-token",
        "YOUR_ACCESS_TOKEN",
        "--refresh-token",
        "YOUR_REFRESH_TOKEN",
        "--client-id",
        "YOUR_CLIENT_ID",
        "--client-secret",
        "YOUR_CLIENT_SECRET"
      ]
    }
  }
}

Tools

• list_forms: List Google Forms from Drive (optional query, pageSize, pageToken).
• get_form: Get form metadata, items, and settings by formId.
• create_form: Create a new, empty form with a title.
• batch_update_form: Apply a list of requests (e.g. createItem, updateFormInfo) to a form.
• list_responses: List responses for a form, with optional filter, pageSize, and pageToken.
• get_response: Get a single response by formId and responseId.
• create_watch: Create a Pub/Sub watch on a form (eventType: SCHEMA or RESPONSES).
• list_watches: List all watches for a form.
• delete_watch: Delete a watch by formId and watchId.

License

MIT