barie-google-forms-mcp

# 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`): ```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 …