Mcp Google Forms

io.github.KamaruSama由 GitHub 账号 KamaruSama 发布v1.0.1更新于 Oct 24, 2026

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

已验证STDIO仅桌面效率与工作流开发者工具

概览

AI 生成的概览

一个本地 MCP 服务器，通过 19 个工具让助手创建、编辑和查看 Google 表单测验，并读取提交的回复。

可以做什么
创建与配置表单：新建测验模式表单、重命名、开关测验模式，读取完整表单 JSON 或精简题目列表，并可核对答案键是否符合预期。添加题目：判断题（单个或批量）、选择题（单选、多选、下拉）、简答或段落文本，以及分节标题或分页。编辑题目：重命名、修改判断题答案、删除和调整顺序。读取回复：列出全部提交回复或按 ID 获取单条回复。还可通过原始 Forms API 批量更新作为备用手段，并检查 OAuth 凭据状态。
适用场景
适合让助手搭建或调整 Google 表单测验、批量添加题目、核对答案键，或直接在对话中拉取提交的回复。适用于已在 Google 表单中工作的教师、培训人员和团队。
运行要求
作为本地进程运行（PyPI 包 mcp-google-forms，通过 uv 启动）。需要启用 Google Forms API 的 Google Cloud 项目、保存到配置目录的 OAuth 桌面客户端凭据 JSON，以及首次 OAuth 授权时使用的浏览器。可选环境变量 GOOGLE_FORMS_MCP_DIR 可覆盖凭据和缓存令牌的存放目录。仅支持桌面客户端。
安装前请注意
服务器会在磁盘上保存 OAuth 凭据和缓存令牌，并申请 forms.body、forms.responses.readonly 和 drive.file 权限范围，因此可以修改表单结构并读取提交的回复。相关工具会创建、编辑、重排和删除题目，raw_batch_update 可执行任意 Forms API 更改。应用前请先检查改动，并妥善保管凭据与令牌文件。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Google Forms，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

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

来源：README.md，提交 514378c

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v1.0.1最新Sep 16, 2026

评分

已满足适用检查项的 40%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分

    请在仓库或注册中心条目中声明许可证。