Skip to content
MCP server

Google Forms MCP

Build Google Forms, publish them and read responses from an AI app

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
self-hosted
Runs
Locally
Version
1.3.2
Listing updated
today

Similar MCP servers

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.

Forms created through the API start unpublished, so they cannot collect answers until someone publishes them. The server keeps publishing and closing as separate steps: closing leaves a form published but stops new submissions, and unpublishing takes it away from respondents. Legacy forms made before Google's publish model may not support these settings.

Responses are strictly read-only. The Forms API can return answers but cannot create, edit or delete them, and the server has no tool that submits a response. File-upload questions can be read on existing forms but cannot be created through the API.

For notifications it can create, renew or remove a Cloud Pub/Sub watch on a form. It requests only the forms.body and forms.responses.readonly scopes, so there is no broad Drive access. It runs locally over stdio with Node.js 20 or newer.

Install

Run in a terminal

claude mcp add mcp-google-forms --env GOOGLE_FORMS_CLIENT_SECRET='<GOOGLE_FORMS_CLIENT_SECRET>' --env GOOGLE_FORMS_REFRESH_TOKEN='<GOOGLE_FORMS_REFRESH_TOKEN>' --env GOOGLE_FORMS_ACCESS_TOKEN='<GOOGLE_FORMS_ACCESS_TOKEN>' -- npx -y mcp-google-forms

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-google-forms": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-forms"
      ],
      "env": {
        "GOOGLE_FORMS_CLIENT_SECRET": "<GOOGLE_FORMS_CLIENT_SECRET>",
        "GOOGLE_FORMS_REFRESH_TOKEN": "<GOOGLE_FORMS_REFRESH_TOKEN>",
        "GOOGLE_FORMS_ACCESS_TOKEN": "<GOOGLE_FORMS_ACCESS_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-google-forms": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-forms"
      ],
      "env": {
        "GOOGLE_FORMS_CLIENT_SECRET": "<GOOGLE_FORMS_CLIENT_SECRET>",
        "GOOGLE_FORMS_REFRESH_TOKEN": "<GOOGLE_FORMS_REFRESH_TOKEN>",
        "GOOGLE_FORMS_ACCESS_TOKEN": "<GOOGLE_FORMS_ACCESS_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-google-forms": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-forms"
      ],
      "env": {
        "GOOGLE_FORMS_CLIENT_SECRET": "<GOOGLE_FORMS_CLIENT_SECRET>",
        "GOOGLE_FORMS_REFRESH_TOKEN": "<GOOGLE_FORMS_REFRESH_TOKEN>",
        "GOOGLE_FORMS_ACCESS_TOKEN": "<GOOGLE_FORMS_ACCESS_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp-google-forms": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-forms"
      ],
      "env": {
        "GOOGLE_FORMS_CLIENT_SECRET": "<GOOGLE_FORMS_CLIENT_SECRET>",
        "GOOGLE_FORMS_REFRESH_TOKEN": "<GOOGLE_FORMS_REFRESH_TOKEN>",
        "GOOGLE_FORMS_ACCESS_TOKEN": "<GOOGLE_FORMS_ACCESS_TOKEN>"
      }
    }
  }
}

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

{
  "mcpServers": {
    "mcp-google-forms": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-google-forms"
      ],
      "env": {
        "GOOGLE_FORMS_CLIENT_SECRET": "<GOOGLE_FORMS_CLIENT_SECRET>",
        "GOOGLE_FORMS_REFRESH_TOKEN": "<GOOGLE_FORMS_REFRESH_TOKEN>",
        "GOOGLE_FORMS_ACCESS_TOKEN": "<GOOGLE_FORMS_ACCESS_TOKEN>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • GOOGLE_FORMS_CLIENT_IDGoogle OAuth2 client id (refresh-token flow).
  • GOOGLE_FORMS_CLIENT_SECRETGoogle OAuth2 client secret (refresh-token flow). Treat it as a secret.
  • GOOGLE_FORMS_REFRESH_TOKENGoogle OAuth2 refresh token, exchanged for access tokens automatically. Treat it as a secret.
  • GOOGLE_FORMS_ACCESS_TOKENStatic OAuth2 access token (~1h lifetime) — alternative to the refresh-token trio, mostly for testing.
  • GOOGLE_FORMS_OAUTH_PORTFixed port for the loopback listener of the in-chat login (127.0.0.1 + PKCE). Set it when the client runs over SSH port forwarding; otherwise a free port is picked per login.
  • GOOGLE_FORMS_API_BASEAPI root override.
  • GOOGLE_FORMS_TIMEOUT_MSPer-request timeout in milliseconds.
  • GOOGLE_FORMS_MAX_RETRIESRetries on transient errors (429 always; 5xx/network for reads).

Tools this server provides (2)

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

create_form
Creates a new unpublished form.
raw_request
Calls Forms API methods that have no dedicated tool.

What it does

19 form tools
Inspect forms and responses, create and edit forms and questions, manage publishing.
Publish control
Publish, unpublish, open or close responses as separate actions.
Pub/Sub watches
Create, renew or delete notification delivery for new submissions.
Narrow scopes
Only forms.body and forms.responses.readonly are requested.
Question types
Add rating, dropdown, date, time, choice or text questions.

Good for

  • Summarize free-text answers from a feedback form
  • Create an RSVP form with meal preference and arrival date
  • Add a required 1 to 5 rating question
  • Stop accepting responses without deleting the form
  • Get notified of new submissions

Pricing

Open source

Runs locally from npm; you supply your own Google OAuth client

Google Forms MCP FAQ

Does a new form accept answers right away?

No. Forms made through the API start unpublished and must be published first.

Can it submit or edit responses?

No. Responses are read-only and the server has no tool that submits answers.

Can it create file-upload questions?

No. The Forms API cannot create them, though existing ones can be read.

How do I sign in to Google?

You can say "connect" in the chat and the server walks you through creating an OAuth client and approving access, or you can supply a client id, client secret and refresh token as environment variables.

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 mcp-google-forms --env GOOGLE_FORMS_CLIENT_SECRET='<GOOGLE_FORMS_CLIENT_SECRET>' --env GOOGLE_FORMS_REFRESH_TOKEN='<GOOGLE_FORMS_REFRESH_TOKEN>' --env GOOGLE_FORMS_ACCESS_TOKEN='<GOOGLE_FORMS_ACCESS_TOKEN>' -- npx -y mcp-google-forms

What are the best alternatives to Google Forms MCP?

The closest alternatives to Google Forms MCP are Ha MCP, Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, dashboard-icons and Concord MCP.

Where this comes from

  • Description: written from the project's README.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers