google-forms-mcp
Manage Google Drive files and folders: create, move, copy, trash, search, share, and manage permissions.
Create, manage, and analyze Google Forms with support for all 11 question types, sections, quiz mode, and response management.
Interact with Google Sheets: create spreadsheets, read, write, and append data, and export as CSV.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@google-forms-mcpCreate a new form titled 'Customer Feedback'"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
๐ฃ Google Forms MCP
Production-grade Model Context Protocol (MCP) server for Google Forms automation.
Create, manage, and analyze Google Forms through an autonomous AI Planner that works with Claude, ChatGPT, Cursor, VS Code, Windsurf, Cline, Roo Code, and any MCP-compatible client.
โจ Features
๐ค Autonomous AI Planner
Automatically detects user intent and interviews the user for missing details.
Validates the execution plan to prevent API errors.
Orchestrates Google Forms tools automatically to build complex forms.
Includes pre-built templates (Hackathon, Survey, Quiz, RSVP).
๐ Form Management
Create forms with title, description, and quiz mode
Update form metadata and settings
Delete / Duplicate / Publish forms
Search for forms in Google Drive
โ All 11 Question Types
Short Answer, Paragraph, Multiple Choice, Checkboxes, Dropdown
File Upload, Linear Scale, Date, Time
Multiple Choice Grid, Checkbox Grid
๐ Sections & Layout
Add, update, delete sections (page breaks)
Add images, videos, and text blocks
๐งช Quiz Mode
Enable quiz grading with point values
Set answer keys with correct answers
Configure right/wrong feedback
๐ Response Management
Read all form responses (paginated)
Get response summary statistics
Export as CSV or JSON
๐ Google Drive Integration
Create folders, move/copy/trash files
Search files and forms
Share with users, groups, or domains
Manage permissions
๐ Google Sheets Integration
Create spreadsheets
Read, write, and append data
Export sheets as CSV
Related MCP server: Google Docs & Drive MCP Server
๐ Quickstart
1. Google Cloud Setup
Go to Google Cloud Console
Create a new project (or select existing)
Enable these APIs:
Google Forms API
Google Drive API
Google Sheets API
Go to APIs & Services โ Credentials
Create OAuth 2.0 Client ID (Desktop application)
Download the credentials or note the Client ID and Client Secret
2. Get a Refresh Token
Use the Google OAuth Playground or the built-in auth flow:
# Option A: Use environment variables with a pre-obtained refresh token
export GOOGLE_CLIENT_ID="your-client-id"
export GOOGLE_CLIENT_SECRET="your-client-secret"
export GOOGLE_REFRESH_TOKEN="your-refresh-token"
# Option B: Interactive flow (opens browser)
export GOOGLE_CLIENT_SECRETS_FILE="path/to/client_secret.json"3. Install & Run
# Using uvx (recommended)
uvx google-forms-mcp
# Using pip
pip install google-forms-mcp
python -m google_forms_mcp
# Using Docker Compose
docker-compose up -d4. Configure Your MCP Client
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"google-forms": {
"command": "uvx",
"args": ["google-forms-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id",
"GOOGLE_CLIENT_SECRET": "your-client-secret",
"GOOGLE_REFRESH_TOKEN": "your-refresh-token"
}
}
}
}Cursor / VS Code / Windsurf
Add to your MCP settings:
{
"mcpServers": {
"google-forms": {
"command": "uvx",
"args": ["google-forms-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id",
"GOOGLE_CLIENT_SECRET": "your-client-secret",
"GOOGLE_REFRESH_TOKEN": "your-refresh-token"
}
}
}
}Cline / Roo Code
Add to your cline_mcp_settings.json:
{
"mcpServers": {
"google-forms": {
"command": "uvx",
"args": ["google-forms-mcp"],
"env": {
"GOOGLE_CLIENT_ID": "your-client-id",
"GOOGLE_CLIENT_SECRET": "your-client-secret",
"GOOGLE_REFRESH_TOKEN": "your-refresh-token"
}
}
}
}๐ง Available Tools (38 tools)
Forms (19 tools)
Tool | Description |
| Create a new Google Form |
| Retrieve complete form structure |
| Update title and description |
| Delete (trash or permanent) |
| Copy an existing form |
| Publish or stop accepting responses |
| Add any of the 11 question types |
| Modify an existing question |
| Remove a question |
| Reorder a question |
| Duplicate an existing question |
| Branch based on choice option |
| Add a section (page break) |
| Update section title/description |
| Remove a section |
| Set section navigation action |
| Update form settings (quiz, progress bar, etc.) |
| Add an image or video |
| Add a text block |
Responses (4 tools)
Tool | Description |
| List all responses (paginated) |
| Get a single response by ID |
| Aggregated statistics |
| Export as CSV or JSON |
Drive (12 tools)
Tool | Description |
| Create a Drive folder |
| Search for Google Forms |
| Search for any files |
| Move to another folder |
| Copy a file |
| Move to trash |
| Restore from trash |
| Get complete file metadata |
| Share with users/groups |
| Transfer file ownership |
| List sharing permissions |
| Remove a permission |
Sheets (7 tools)
Tool | Description |
| Create a new spreadsheet |
| Get spreadsheet metadata |
| Read from a range |
| Write to a range |
| Append rows |
| Clear data from a range |
| Export as CSV |
โ๏ธ Configuration
Environment Variable | Description | Default |
| OAuth 2.0 Client ID | Required |
| OAuth 2.0 Client Secret | Required |
| Pre-obtained Refresh Token | Required |
| Path to client secrets JSON | โ |
| Transport mode: |
|
| HTTP port (when transport=http) |
|
| Log level |
|
| Token storage path |
|
โ ๏ธ Known Limitations
These are Google Forms API limitations, not limitations of this MCP:
Feature | Status |
Theme customization (colors, fonts, headers) | โ Not supported by API |
Delete responses | โ Not supported by API |
Link Form to Sheets | โ Not supported via API (requires UI/Apps Script) |
Settings | โ Now fully supported |
๐ค Contributing
Contributions are welcome! See CONTRIBUTING.md for guidelines.
# Clone the repo
git clone https://github.com/your-org/google-forms-mcp.git
cd google-forms-mcp
# Install dependencies
uv sync --dev
# Run tests
uv run pytest
# Lint & format
uv run ruff check src/ tests/
uv run ruff format src/ tests/๐ License
MIT License โ see LICENSE for details.
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/mr-sanjai-offl/google-forms-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server