Google Forms MCP

MCP server for Google Forms with OAuth token-file auth.

Breaking Change (v1 auth migration)

GOOGLE_REFRESH_TOKEN is no longer used.

Run one-time auth instead:

GOOGLE_CLIENT_ID="your-client-id" \
GOOGLE_CLIENT_SECRET="your-client-secret" \
npx -y google-forms-mcp auth

This stores the refresh token at ~/.config/google-docs-mcp/token.json (respects XDG_CONFIG_HOME).

Setup

1. Enable APIs in Google Cloud:

• Google Forms API
• Google Drive API
• Google Docs API
• Google Sheets API

2. Create OAuth 2.0 credentials (Desktop app).
3. Run auth command above once.
4. Add MCP config:

{
  "mcpServers": {
    "google-forms-mcp": {
      "command": "npx",
      "args": ["-y", "google-forms-mcp"],
      "env": {
        "GOOGLE_CLIENT_ID": "your-client-id",
        "GOOGLE_CLIENT_SECRET": "your-client-secret"
      },
      "type": "stdio"
    }
  }
}

Shared Token with google-docs-mcp

This project intentionally shares token storage with google-docs-mcp for DRY setup.

google-forms-mcp auth requests superset scopes:

• forms
• drive
• documents
• spreadsheets

That keeps one token usable for both MCP servers.

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 in the form.

Multiple Choice Options

Options support both formats:

• Simple: ["Option A", "Option B"]
• With description: [{ "label": "Option A", "description": "Details" }]

Use multiSelect: true for checkboxes.

License

MIT