Back to Directory/Developer Tools

io.github.KamaruSama/mcp-google-forms

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

Developer ToolsPythonv1.0.1

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


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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx mcp-google-forms

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-kamarusama-mcp-google-forms": {
      "command": "uvx",
      "args": [
        "mcp-google-forms"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

mcp-google-formspypi

Compatible MCP Clients

io.github.KamaruSama/mcp-google-forms works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More