barie-google-forms-mcp 0.1.3

Google Forms MCP Server for managing forms and responses via the Model Context Protocol

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