Mcp Google Forms

io.github.KamaruSamaPublished by GitHub account KamaruSamav1.0.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyProductivity & WorkflowDeveloper Tools

Overview

AI-generated overview

A local MCP server that lets an assistant create, edit and inspect Google Forms quizzes and read their responses through 19 tools.

What you can do
Create and configure forms: make a new quiz-mode form, rename it, toggle quiz mode on or off, and read the full form JSON or a concise question list, including a check of answer keys against expectations. Add questions: true/false (single or bulk), multiple choice (radio, checkbox, dropdown), short or paragraph text, and section headers or page breaks. Edit questions: rename, re-key a true/false answer, delete and reorder items. Read responses: list all submitted responses or fetch one by ID. Run raw Forms API batch updates as an escape hatch, and check OAuth credential status.
When to use it
Useful when you want an assistant to build or restructure a Google Forms quiz, bulk-add questions, verify answer keys, or pull submitted responses without leaving the chat. Suited to teachers, trainers and teams that already work in Google Forms.
Requirements
Runs as a local process (PyPI package mcp-google-forms, started via uv). Needs a Google Cloud project with the Google Forms API enabled, an OAuth desktop client credentials JSON saved to the config directory, and a browser for the first-time OAuth consent. The optional GOOGLE_FORMS_MCP_DIR variable overrides where credentials and the cached token are stored. Desktop client only.
Before you install
The server stores OAuth credentials and a cached token on disk and requests the forms.body, forms.responses.readonly and drive.file scopes, so it can change form structure and read submitted responses. Tools create, edit, reorder and delete questions, and raw_batch_update can make arbitrary Forms API changes. Review changes before applying them, and keep the credentials and token files private.

Installation

In SourceWeft

  1. Open Mcp Google Forms in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

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

SectionToolPurpose
Authauth_statusCheck OAuth credential state
Create / metadatacreate_quiz_formNew form in quiz mode
rename_formChange title/description
set_quiz_modeToggle quiz on/off
Readget_formFull form JSON
list_questionsConcise item list
verify_answer_keysDiff current vs expected answer keys
Addadd_true_false_questionSingle T/F question
batch_add_true_falseBulk T/F
add_multiple_choice_questionRadio / checkbox / dropdown
add_text_questionShort or paragraph text
add_section_headerPage break / section
Editupdate_question_titleRename question
update_true_false_answerRe-key a T/F answer
delete_questionRemove item
move_questionReorder
Responseslist_responsesAll submitted responses
get_responseOne response by ID
Escape hatchraw_batch_updateRaw 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

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:

Contact

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

Source: README.md at commit 514378c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.