# Google Forms MCP
MCP server for Google Forms.
## Quick Start
```bash
npx skills add https://github.com/udecode/google-forms-mcp --skills google-forms
```
Then run `/google-forms` in Claude Code to complete setup.
## Manual Installation
```bash
git clone https://github.com/udecode/google-forms-mcp.git ~/.claude/mcp/google-forms-mcp
cd ~/.claude/mcp/google-forms-mcp
bun install && bun run build
```
### Setup
1. Enable **Google Forms API** + **Google Drive API** at [console.cloud.google.com](https://console.cloud.google.com)
2. Create OAuth 2.0 credentials (Desktop app)
3. Get refresh token:
```bash
cd ~/.claude/mcp/google-forms-mcp
GOOGLE_CLIENT_ID="..." GOOGLE_CLIENT_SECRET="..." bun run token
```
4. Add to `.mcp.json`:
```json
{
"mcpServers": {
"google-forms-mcp": {
"command": "bun",
"args": ["/Users/YOUR_USERNAME/.claude/mcp/google-forms-mcp/build/index.js"],
"env": {
"GOOGLE_CLIENT_ID": "...",
"GOOGLE_CLIENT_SECRET": "...",
"GOOGLE_REFRESH_TOKEN": "..."
}
}
}
}
```
## Tools
| Tool | Description |
|------|-------------|
| `create_form` | Create form |
| `get_form` | Get form details |
| `list_forms` | List all forms |
| `update_form` | Update title/description |
| `delete_form` | Delete form |
| `add_section` | Add visual divider (no page break) |
| `add_page` | Add page break (requires Next button) |
| `add_text_question` | Add text question |
| `add_multiple_choice_question` | Add radio/checkbox question |
| `update_question` | Modify question |
| `delete_question` | Remove question |
| `get_form_responses` | Get responses |
### Item Order (CRITICAL)
**All items are added at index 0.** The LAST item you add appears FIRST.
For a form with sections, add in reverse:
```
create_form → update_form
add: last question
add: last section header
...
add: first question
add: first section header ← LAST (appears first)
```
### Multiple Choice Options
Options support both formats:
- Simple: `["Option A", "Option B"]`
- With description: `[{ "label": "Option A", "description": "Details" }]`
Set `multiSelect: true` for checkboxes, omit for radio buttons.
## License
MIT
README 원본 보기