About Google Forms MCP Server
Google Forms MCP Server is an MCP server built on the Google Forms API for creating forms, adding questions, and retrieving form details and responses. It suits users who want an AI assistant to generate or manage Google Forms.
Key features
- 01Create new Google Forms
- 02Add text and multiple choice questions
- 03Retrieve form details
- 04Retrieve form responses
Use cases
- 01Generate a survey through a conversation
- 02Read response data from an existing form
MCP support
This project is an MCP server that exposes form-related tools to MCP clients such as the Claude desktop app. It requires Google OAuth credentials and a refresh token.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEGoogle Forms MCP Server
This MCP server uses the Google Forms API to provide functions such as creating, editing, and retrieving responses for forms.
Build Method
Initial Setup
After cloning the repository, install dependencies
cd google-forms-mcp
Build the Server
# Build the main MCP server
npm run build
Build the Refresh Token Acquisition Script
# Build the refresh token acquisition script
npm run build:token
Execution in Development Environment
# Run the server directly
node build/index.js
# Or, use npm script
npm run start
Setup Method
-
Create a project in Google Cloud Console and enable the Google Forms API.
- https://console.cloud.google.com/
- Search for "Google Forms API" from APIs & Services > Library and enable it.
-
Obtain OAuth 2.0 Client ID and Secret.
- APIs & Services > Credentials > Create Credentials > OAuth client ID
- Select Application type: "Desktop app"
-
Set environment variables and obtain the refresh token.
export GOOGLE_CLIENT_ID="YOUR_CLIENT_ID" export GOOGLE_CLIENT_SECRET="YOUR_CLIENT_SECRET" cd google-forms-mcp npm run build node build/get-refresh-token.jsNote: If an error occurs when running get-refresh-token.js, execute the following command:
cd google-forms-mcp npm run build:token node build/get-refresh-token.js -
Copy the displayed refresh token.
-
Update the Claude desktop app's configuration file.
- Open
~/Library/Application Support/Claude/claude_desktop_config.json. - Add environment variables to the
google-forms-mcpin themcpServerssection:
"google-forms-mcp": { "command": "node", "args": [ "/path/to/your/google-forms-mcp/build/index.js" # Update this path ], "env": { "GOOGLE_CLIENT_ID": "YOUR_CLIENT_ID", "GOOGLE_CLIENT_SECRET": "YOUR_CLIENT_SECRET", "GOOGLE_REFRESH_TOKEN": "YOUR_REFRESH_TOKEN" } } - Open
-
Restart the Claude desktop app.
Available Tools
This MCP server provides the following tools:
create_form- Create a new Google Formadd_text_question- Add a text question to the formadd_multiple_choice_question- Add a multiple choice question to the formget_form- Get form detailsget_form_responses- Get form responses
Usage Example
Create a form and add some questions.
Claude uses MCP tools like the following to create the form:
- Use the
create_formtool to create a new form - Use
add_text_questionoradd_multiple_choice_questiontools to add questions - Display the URL of the created form
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.
