io.github.KamaruSama/mcp-google-forms

Official

by KamaruSama · Python

19 tools for Google Forms: create quizzes, add questions, set answer keys, read responses.

Provides 19 tools to create, manage, and analyze Google Forms and quiz responses.

Topics

anthropicclaudeclaude-codemcpmcp-servermodel-context-protocollikezara

README.md3 KBView on GitHub

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:

code

~/.config/google-forms-mcp/credentials.json

2. Register with Claude Code

bash

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

Install

Configuration

Environment variables

GOOGLE_FORMS_MCP_DIR

Override the directory where OAuth credentials.json and token.json are stored (default: ~/.config/google-forms-mcp).

claude_desktop_config.json

{
  "mcpServers": {
    "mcp-google-forms": {
      "command": "uvx",
      "args": [
        "mcp-google-forms"
      ],
      "env": {
        "GOOGLE_FORMS_MCP_DIR": "<YOUR_GOOGLE_FORMS_MCP_DIR>"
      }
    }
  }
}