mcp-google-forms

<!-- mcp-name: io.github.KamaruSama/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

1. Go to https://console.cloud.google.com → create/select a project
2. APIs & Services → Library → enable Google Forms API
3. OAuth consent screen → External → add yourself as test user
4. Credentials → Create Credentials → OAuth client ID → Desktop app
5. 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 structure
• forms.responses.readonly — read responses
• drive.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).