google-forms

Google Forms MCP

设置

1. 在 console.cloud.google.com 启用 Google Forms API + Google Drive API
2. 创建 OAuth 2.0 凭据（Desktop app 类型）
3. 获取刷新令牌：

   cd ~/.claude/mcp/google-forms-mcp
   bun install && bun run build
   GOOGLE_CLIENT_ID="..." GOOGLE_CLIENT_SECRET="..." bun run token
   

4. 添加到 .mcp.json（使用完整路径，不要使用 ~）：

   {
     "mcpServers": {
       "google-forms-mcp": {
         "command": "bun",
         "args": ["/Users/USERNAME/.claude/mcp/google-forms-mcp/build/index.js"],
         "env": {
           "GOOGLE_CLIENT_ID": "...",
           "GOOGLE_CLIENT_SECRET": "...",
           "GOOGLE_REFRESH_TOKEN": "..."
         }
       }
     }
   }
   

5. 运行 /mcp reset 以加载

工具

工具	描述
create_form	创建表单（返回 formId）
update_form	更新标题/描述
get_form	获取表单结构
list_forms	列出所有表单
delete_form	永久删除表单
add_section	视觉分隔符（不分页）
add_page	分页符（需要“下一步”按钮）
add_text_question	自由文本输入
add_multiple_choice_question	单选按钮或复选框
update_question	修改现有问题
delete_question	按索引删除问题
get_form_responses	获取已提交的答复

项目顺序（重要）

所有项目都会添加到索引 0。 最后添加的项目会显示在最前面。

对于包含多个部分的表单，请按相反顺序添加：

1. create_form → update_form (description)
2. Additional Notes (last item)
3. Last section questions (e.g., 4.2, 4.1)
4. Last section header (Section 4)
5. Previous section questions (e.g., 3.4, 3.3, 3.2, 3.1)
6. Previous section header (Section 3)
7. ... continue for all sections ...
8. First section questions (e.g., 1.3, 1.2, 1.1)
9. First section header (Section 1) ← ADD LAST, APPEARS FIRST

单选题选项

支持两种格式：

// Simple strings
options: ["Option A", "Option B", "Option C"]

// With descriptions (renders as "Label – Description")
options: [
  { label: "Option A", description: "Details about A" },
  { label: "Option B", description: "Details about B" }
]

参数：

• includeOther: true - 添加带文本框的“其他”选项
• multiSelect: true - 复选框（可多选）
• multiSelect: false - 单选按钮（单选，默认）

API 限制

错误	原因	解决方案
Only info.title can be set when creating a form	创建时无法设置描述	创建后使用 update_form
Displayed text cannot contain newlines	选项中不能包含 \n	使用“ – ”（短横线）分隔标签和描述
Cannot set option.value when isOther is true	“其他”选项不能设置值	已在 MCP 中修复——直接使用 includeOther: true

部分与页面

• add_section - 仅添加视觉分隔符，仍位于同一页面（使用 textItem）
• add_page - 创建分页符，用户点击“下一步”（使用 pageBreakItem）

对于单页调查问卷，始终使用 add_section。