How do I install the Google Forms skill?

Run npx skillmds@latest add udecode/google-forms in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Google Forms safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Google Forms?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Google Forms free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Google Forms?

udecode (@udecode) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Google Forms by udecode — Agent Skill

Name: Google Forms
Author: udecode

Google Forms

Create and manage Google Forms programmatically via MCP. Use when: (1) creating survey forms, (2) adding questions/sections to forms, (3) getting form responses, (4) converting AskUserQuestion to shareable forms. Covers setup, all tools, item ordering, and API limitations.

udecode 259d396 3.4 KB Updated Sep 17, 2026

File contents

Google Forms MCP

Setup

Enable Google Forms API + Google Drive API at console.cloud.google.com
Create OAuth 2.0 credentials (Desktop app type)

Get refresh token:

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

Add to .mcp.json (use full path, not ~):

{
  "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": "..."
      }
    }
  }
}

Run /mcp reset to load

Tools

Tool	Description
`create_form`	Create form (returns formId)
`update_form`	Update title/description
`get_form`	Get form structure
`list_forms`	List all forms
`delete_form`	Delete form permanently
`add_section`	Visual divider (no page break)
`add_page`	Page break (requires Next button)
`add_text_question`	Free text input
`add_multiple_choice_question`	Radio or checkbox
`update_question`	Modify existing question
`delete_question`	Remove question by index
`get_form_responses`	Get submitted responses

Item Ordering (CRITICAL)

All items are added at index 0. The LAST item you add appears FIRST.

For a multi-section form, add in reverse order:

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

Multiple Choice Options

Two formats supported:

// 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" }
]

Parameters:

includeOther: true - Adds "Other" with text field
multiSelect: true - Checkboxes (multi-select)
multiSelect: false - Radio buttons (single choice, default)

API Limitations

Error	Cause	Solution
`Only info.title can be set when creating a form`	Can't set description on create	Use `update_form` after `create_form`
`Displayed text cannot contain newlines`	Options can't have `\n`	Use " – " (en-dash) to separate label from description
`Cannot set option.value when isOther is true`	Other option can't have value	Fixed in MCP - just use `includeOther: true`

Section vs Page

add_section - Visual divider only, stays on same page (uses textItem)
add_page - Creates page break, user clicks "Next" (uses pageBreakItem)

For single-page surveys, always use add_section.

---name: google-formsdescription: Create and manage Google Forms programmatically via MCP. Use when: (1) creating survey forms, (2) adding questions/sections to forms, (3) getting form responses, (4) converting AskUserQuestion to shareable forms. Covers setup, all tools, item ordering, and API limitations.---# Google Forms MCP## Setup1. Enable **Google Forms API** + **Google Drive API** at console.cloud.google.com2. Create OAuth 2.0 credentials (Desktop app type)3. Get refresh token: ```bash cd ~/.claude/mcp/google-forms-mcp bun install && bun run build GOOGLE_CLIENT_ID="..." GOOGLE_CLIENT_SECRET="..." bun run token ```4. Add to `.mcp.json` (use full path, not `~`): ```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. Run `/mcp reset` to load## Tools| Tool | Description ||------|-------------|| `create_form` | Create form (returns formId) || `update_form` | Update title/description || `get_form` | Get form structure || `list_forms` | List all forms || `delete_form` | Delete form permanently || `add_section` | Visual divider (no page break) || `add_page` | Page break (requires Next button) || `add_text_question` | Free text input || `add_multiple_choice_question` | Radio or checkbox || `update_question` | Modify existing question || `delete_question` | Remove question by index || `get_form_responses` | Get submitted responses |## Item Ordering (CRITICAL)**All items are added at index 0.** The LAST item you add appears FIRST.For a multi-section form, add in reverse order:```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```## Multiple Choice OptionsTwo formats supported:```javascript// Simple stringsoptions: ["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" }]```Parameters:- `includeOther: true` - Adds "Other" with text field- `multiSelect: true` - Checkboxes (multi-select)- `multiSelect: false` - Radio buttons (single choice, default)## API Limitations| Error | Cause | Solution ||-------|-------|----------|| `Only info.title can be set when creating a form` | Can't set description on create | Use `update_form` after `create_form` || `Displayed text cannot contain newlines` | Options can't have `\n` | Use " – " (en-dash) to separate label from description || `Cannot set option.value when isOther is true` | Other option can't have value | Fixed in MCP - just use `includeOther: true` |## Section vs Page- **`add_section`** - Visual divider only, stays on same page (uses `textItem`)- **`add_page`** - Creates page break, user clicks "Next" (uses `pageBreakItem`)For single-page surveys, always use `add_section`.

Frequently asked questions