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 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