Connects Claude to the Google Forms API with 19 tools covering the full lifecycle: create quiz forms, add multiple choice or true/false questions in bulk, set answer keys, read and verify grading config, pull submitted responses, and reorder or rename items. Authentication uses OAuth with forms.body and forms.responses.readonly scopes. Useful when you're building or maintaining quizzes programmatically, need to diff expected answers against what's actually configured, or want to automate response collection without touching the Forms UI. Includes a raw batch update escape hatch for unsupported API calls.
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.
| Section | Tool | Purpose |
|---|---|---|
| Auth | auth_status | Check OAuth credential state |
| Create / metadata | create_quiz_form | New form in quiz mode |
rename_form | Change title/description | |
set_quiz_mode | Toggle quiz on/off | |
| Read | get_form | Full form JSON |
list_questions | Concise item list | |
verify_answer_keys | Diff current vs expected answer keys | |
| Add | add_true_false_question | Single T/F question |
batch_add_true_false | Bulk T/F | |
add_multiple_choice_question | Radio / checkbox / dropdown | |
add_text_question | Short or paragraph text | |
add_section_header | Page break / section | |
| Edit | update_question_title | Rename question |
update_true_false_answer | Re-key a T/F answer | |
delete_question | Remove item | |
move_question | Reorder | |
| Responses | list_responses | All submitted responses |
get_response | One response by ID | |
| Escape hatch | raw_batch_update | Raw Forms API calls |
~/.config/google-forms-mcp/credentials.json
claude mcp add google-forms -s user -- \
uv run --directory /path/to/mcp-google-forms python server.py
On the first tool call, the server opens a browser for OAuth consent. Token is cached at ~/.config/google-forms-mcp/token.json.
forms.body — create/edit form structureforms.responses.readonly — read responsesdrive.file — attach images via DriveIf this tool helps your workflow, consider supporting development:
Copyright © 2026 likezara™. All rights reserved. Developed by Kamaru (pen name).
GOOGLE_FORMS_MCP_DIROverride the directory where OAuth credentials.json and token.json are stored (default: ~/.config/google-forms-mcp).