google-forms

Google Forms MCP

セットアップ

1. console.cloud.google.com で Google Forms API と Google Drive API を有効にします
2. OAuth 2.0 認証情報を作成します（Desktop app タイプ）
3. refresh token を取得します：

   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	改ページ（Next ボタンが必要です）
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

選択肢

次の 2 つの形式に対応しています：

// 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	作成時に説明を設定できません	create_form の後に update_form を使用します
Displayed text cannot contain newlines	選択肢に \n を含められません	ラベルと説明を区切るには「 – 」（en ダッシュ）を使用します
Cannot set option.value when isOther is true	「その他」の選択肢には値を設定できません	MCP で修正済みです。includeOther: true を使用するだけです

セクションとページ

• add_section - 視覚的な区切りのみで、同じページにとどまります（textItem を使用）
• add_page - 改ページを作成し、ユーザーが「Next」をクリックします（pageBreakItem を使用）

1 ページのアンケートでは、常に add_section を使用してください。