mcp-google-forms

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: [e-mail]
• Commercial / licensing: [e-mail]

Copyright © 2026 likezara™. All rights reserved. Developed by Kamaru (pen name).