English Français العربية

io.github.KamaruSama/mcp-google-forms

Official registry Other

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package mcp-google-forms
Claude Code 
claude mcp add mcp-google-forms -e 'GOOGLE_FORMS_MCP_DIR=<GOOGLE_FORMS_MCP_DIR>' -- uvx mcp-google-forms==1.0.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-google-forms": {
            "command": "uvx",
            "args": [
                "mcp-google-forms==1.0.1"
            ],
            "env": {
                "GOOGLE_FORMS_MCP_DIR": "<GOOGLE_FORMS_MCP_DIR>"
            }
        }
    }
}

Environment variables

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

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. mcp-google-forms
  2. Tools at a glance
  3. Install
  4. Scopes
  5. Support the project ❤
  6. Contact

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

  • Portfolio / general: k.kamarux@gmail.com
  • Commercial / licensing: contact@likezara.com

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

Frequently asked questions

What is io.github.KamaruSama/mcp-google-forms?

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

How do I install io.github.KamaruSama/mcp-google-forms?

It runs on your machine. In Claude Code: claude mcp add mcp-google-forms -e 'GOOGLE_FORMS_MCP_DIR=<GOOGLE_FORMS_MCP_DIR>' -- uvx mcp-google-forms==1.0.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.KamaruSama/mcp-google-forms need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.KamaruSama/mcp-google-forms open source?

Its code is public on GitHub, but the repository does not declare a standard license.

Who maintains io.github.KamaruSama/mcp-google-forms?

It is published by KamaruSama. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.