mcp-google-forms

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