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 | 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 |
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.py
3. 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).