用途:通过 MCP 协议以编程方式创建和管理 Google Forms,适用于创建问卷表单、向表单添加题目与分节、读取表单结构以及获取已提交的回复。
主要能力(工具):create_form 创建表单并返回 formId;update_form 更新标题/描述;get_form 获取表单结构;list_forms 列出所有表单;delete_form 永久删除表单;add_section 添加视觉分隔(非分页);add_page 添加分页(需点击 Next);add_text_question 添加自由文本题;add_multiple_choice_question 添加单选或复选框题;update_question 修改已有题目;delete_question 按索引删除题目;get_form_responses 获取已提交的回复。
使用方式:需在 console.cloud.google.com 启用 Google Forms API 与 Google Drive API,创建 OAuth 2.0 凭据(Desktop app 类型),获取 refresh token:cd ~/.claude/mcp/google-forms-mcp,bun install && bun run build,GOOGLE_CLIENT_ID="..." GOOGLE_CLIENT_SECRET="..." bun run token。随后在 .mcp.json 中配置(使用完整路径而非 ~),command 为 bun,args 指向 build/index.js,env 填入 GOOGLE_CLIENT_ID、GOOGLE_CLIENT_SECRET、GOOGLE_REFRESH_TOKEN,运行 /mcp reset 加载。
重要限制:所有条目都插入到索引 0,最后添加的条目显示在最前,多分节表单需按逆序添加。多选题选项支持字符串数组或含 label/description 的对象(渲染为“Label – Description”),参数 includeOther 添加“Other”文本框,multiSelect 为 true 时用复选框、false 时用单选(默认)。API 限制:创建表单时只能设置 info.title,描述需创建后用 update_form 设置;显示文本不能含换行,选项不能用 \n,用“ – ”分隔标签与描述;isOther 为 true 时不能设置 option.value,MCP 已修复,直接使用 includeOther: true。add_section 仅作视觉分隔(textItem),add_page 产生分页(pageBreakItem),单页问卷应使用 add_section。