Skip to content
MCP server

Google Forms MCP

Read Google Forms questions and responses and create forms from an assistant

Runs locallyStatus and history
Pricing
Open source
Platforms
vscode, CLI, self-hosted
Runs
Locally
Version
26.11.14
Listing updated
3 days ago

About Google Forms MCP

Google Forms MCP is an open-source MCP server for productivity. It runs locally on your machine and is started by your AI client.

Reading comes first: forms_get returns a form's title, settings and every question with its ID and type, forms_list_responses returns up to 5,000 responses keyed by question ID, and forms_get_response fetches one. Because answers are keyed by ID, the agent reads the form first to match them to question text.

A forms_admin tool creates forms, adds, updates and deletes questions, and changes title, description or the quiz setting. delete_question needs confirm: true. File-upload answers come back as Drive references only, and you need edit access to read responses. Unlike the Keep server, it works with personal Google accounts.

It installs as a free MIT VS Code extension for eight agents or runs from npm.

Install

Run in a terminal

claude mcp add google-forms-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-forms-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "google-forms-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-forms-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "google-forms-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-forms-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "google-forms-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-forms-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "google-forms-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-forms-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "google-forms-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@renzo.johnson/google-forms-mcp"
      ],
      "env": {
        "GOOGLE_OAUTH_CLIENT_SECRET": "<GOOGLE_OAUTH_CLIENT_SECRET>",
        "GOOGLE_OAUTH_REFRESH_TOKEN": "<GOOGLE_OAUTH_REFRESH_TOKEN>"
      }
    }
  }
}

Configuration

  • GOOGLE_APPLICATION_CREDENTIALSPath to a service account key or authorized_user JSON file. Optional if you use gcloud Application Default Credentials or the OAuth variables.
  • GOOGLE_OAUTH_CLIENT_IDOAuth client ID. Set together with the client secret and refresh token.
  • GOOGLE_OAUTH_CLIENT_SECRETOAuth client secret.
  • GOOGLE_OAUTH_REFRESH_TOKENOAuth refresh token with the Google Forms scopes.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

forms_get
Reads a form's title, settings and questions.
forms_list_responses
Lists responses keyed by question ID, up to 5,000.
forms_get_response
Gets one response.
forms_admin
Creates forms and adds, updates or deletes questions and settings.

What it does

Form structure reads
Returns questions, IDs, types and settings.
Response listing
Lists responses after a given time.
Question editing
Adds and updates questions with options and required flags.
Quiz setting
Changes quiz mode.
Confirmed deletes
Deleting a question requires confirm.

Good for

  • Summarise survey free-text answers
  • Count responses this week
  • Review a form for overlapping options
  • Create a feedback form

Pricing

Open source

Free and MIT licensed

Prices change. Check renzojohnson.com before you buy.

Google Forms MCP FAQ

Does it work with personal accounts?

Yes.

Are uploaded files read?

No, only Drive references.

What permission is needed?

Edit access to the form.

Is Google Forms MCP free?

Yes. Google Forms MCP is open source, so you can use and self-host it for free.

How do I add Google Forms MCP to Claude Code?

Run this command in your terminal: claude mcp add google-forms-mcp --env GOOGLE_OAUTH_CLIENT_SECRET='<GOOGLE_OAUTH_CLIENT_SECRET>' --env GOOGLE_OAUTH_REFRESH_TOKEN='<GOOGLE_OAUTH_REFRESH_TOKEN>' -- npx -y @renzo.johnson/google-forms-mcp

What are the best alternatives to Google Forms MCP?

The closest alternatives to Google Forms MCP are Ha MCP, Concord MCP, note1, CalderFlow and nicemails.

Alternatives to Google Forms MCP

  1. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity
  2. Concord MCP

    MCP server

    Local-first MCP server for messaging and shared work-state between coding agents

    Runs locally
    • Freemium
    • 1.3K GitHub stars
    • Developer tools
  3. note1

    MCP server

    MCP server giving AI assistants search and summaries across your note1 meetings

    • 4 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Productivity
  4. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media
  5. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  6. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media