mcp-google-forms
Provides tools for creating, editing, inspecting, and managing Google Forms, including CRUD operations on form structure, questions, and responses, as well as quiz mode management and answer key verification.
Click on "Deploy 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., "@mcp-google-forms Create a new quiz form titled Employee Satisfaction Survey and enable grading."
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.
mcp-google-forms
MCP server for managing Google Forms — quizzes, grading, images, responses.
Exposes 19 tools for creating, editing, inspecting, and managing Google Forms through the Model Context Protocol. Built for use with Claude Code, Claude Desktop, or any MCP-compatible client.
Tools at a glance
Section | Tool | Purpose |
Auth | Check OAuth credential state | |
Create / metadata | New form in quiz mode | |
Change title/description | ||
Toggle quiz on/off | ||
Read | Full form JSON | |
Concise item list | ||
Diff current vs expected answer keys | ||
Add | Single T/F question | |
Bulk T/F | ||
Radio / checkbox / dropdown | ||
Short or paragraph text | ||
Page break / section | ||
Edit | Rename question | |
Re-key a T/F answer | ||
Remove item | ||
Reorder | ||
Responses | All submitted responses | |
One response by ID | ||
Escape hatch | Raw Forms API calls |
Related MCP server: Google Forms MCP
Install
1. Enable API + get credentials
Go to https://console.cloud.google.com → create/select a project
APIs & Services → Library → enable Google Forms API
OAuth consent screen → External → add yourself as test user
Credentials → Create Credentials → OAuth client ID → Desktop app
Download JSON → save as:
~/.config/google-forms-mcp/credentials.json
2. Register with Claude Code
claude mcp add google-forms -s user -- \
uv run --directory /path/to/mcp-google-forms python server.py3. First use
On the first tool call, the server opens a browser for OAuth consent. Token is cached at ~/.config/google-forms-mcp/token.json.
Scopes
forms.body— create/edit form structureforms.responses.readonly— read responsesdrive.file— attach images via Drive
Support the project ❤
If this tool helps your workflow, consider supporting development:
Ko-fi: https://ko-fi.com/kamaru
Contact
Portfolio / general: k.kamarux@gmail.com
Commercial / licensing: contact@likezara.com
Copyright © 2026 likezara™. All rights reserved. Developed by Kamaru (pen name).
Available Tools
19 toolsadd_multiple_choice_questionB
Add a choice question (radio/checkbox/dropdown) with answer key.
Inputs: form_id (required), title (required), options (required), correct_answers (required), +4 more. Returns: object
add_section_headerC
Add a page-break / section header.
Inputs: form_id (required), title (required), description, index. Returns: object
add_text_questionC
Add a short-answer or paragraph text question. Optional answer key.
Inputs: form_id (required), title (required), correct_answers, points, +3 more. Returns: object
add_true_false_questionB
Append (or insert at index) a True/False question with answer key.
Inputs: form_id (required), title (required), correct_answer (required), points, +2 more. Returns: object
auth_statusA
Report whether OAuth credentials and token are in place.
Inputs: no named parameters. Returns: object
batch_add_true_falseA
Bulk add True/False questions.
Each question dict: {"title": str, "correct": bool, "points": int?, "required": bool?}.
If clear_existing=True, deletes all existing items first.
Inputs: form_id (required), questions (required), start_index, clear_existing. Returns: object
create_quiz_formA
Create a new Google Form in quiz mode. Returns formId and responderUri.
Inputs: title (required), document_title. Returns: object
delete_questionC
Delete the item at the given index.
Inputs: form_id (required), index (required). Returns: object
get_formB
Fetch full form metadata, items, and settings.
Inputs: form_id (required). Returns: object
get_responseB
Fetch a single response by id.
Inputs: form_id (required), response_id (required). Returns: object
list_questionsC
Return a concise list of items: index, itemId, title, correctAnswer, points.
Inputs: form_id (required). Returns: result
list_responsesC
List submitted responses for a form.
Inputs: form_id (required). Returns: object
move_questionC
Reorder a question from one index to another.
Inputs: form_id (required), from_index (required), to_index (required). Returns: object
raw_batch_updateC
Escape hatch: pass raw Google Forms API batchUpdate requests.
Inputs: form_id (required), requests (required). Returns: object
rename_formB
Update form's displayed title, description, and/or Drive document title.
Inputs: form_id (required), title, description, document_title. Returns: object
set_quiz_modeC
Toggle quiz grading mode on/off.
Inputs: form_id (required), is_quiz. Returns: object
update_question_titleC
Change the title/text of the question at the given index.
Inputs: form_id (required), index (required), new_title (required). Returns: object
update_true_false_answerB
Update the answer key (correct T/F) for a True/False question at index.
Inputs: form_id (required), index (required), correct_answer (required), points. Returns: object
verify_answer_keysA
Compare current answer keys to an expected list.
Each expected item: {"index": int, "correct": "ถูก"|"ผิด"|str}.
Returns {matches: [...], mismatches: [...]}.
Inputs: form_id (required), expected (required). Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 19 tools
Each tool has a distinct purpose with clear boundaries. Question type additions are separate, bulk operations are explicitly named, and utility tools like auth_status and raw_batch_update are well-defined.
Most tools follow verb_noun snake_case pattern. Minor deviations like 'auth_status' (noun instead of verb) and 'raw_batch_update' (adjective prefix) are present but do not significantly hinder consistency.
19 tools appropriately cover the scope of Google Forms management including creation, editing, bulk operations, responses, and authentication, without being overwhelming or sparse.
Core CRUD for questions, form settings, and responses are covered. Missing question types (e.g., linear scale, date) and lack of question type change are minor gaps, but the tool set is sufficient for quiz management.
Maintenance
Related MCP Connectors
Read-only MCP server for ClassQuill, a tutoring-business-management platform.
MCP server for managing FormDesigner forms, fields, logic rules, themes, and entries
Remote MCP server for deterministic educational practice-assessment score conversions.
Fillo MCP server — provision, scaffold, publish, and query forms from your coding agent.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceMCP server for Dashform (getaiform.com) - create and manage AI-powered forms, quizzes, and surveys. Supports form creation, response collection, analytics, and AI-driven form building with 15 tools across form management, response handling, and AI operations.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for reading, editing, and publishing Google Forms with the official Google Forms API. Enables AI agents to programmatically create, modify, and manage forms and responses.MIT
- AlicenseNot gradedqualityDmaintenanceMCP server for Google Docs, Sheets & Drive with full formatting support.319 npm1MIT
- AlicenseAqualityBmaintenanceAn MCP server for the Google Forms API that enables creating and editing forms, publishing them, reading responses, and setting up push notifications from AI clients using natural language.19207 npmMIT