Google Forms MCP Server

by matteoantoci

15 270 downloads Not rated yet
GitHub

About

This MCP server uses the Google Forms API to provide functions such as creating, editing, and retrieving responses for forms. It is intended for use with AI assistants like Claude to programmatically manage Google Forms.

Explore

- Create a new Google Form
- Add text questions to a form
- Add multiple choice questions to a form
- Retrieve form details
- Retrieve form responses

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Google Forms MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

After cloning the repository, install dependencies

cd google-forms-mcp


1. 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.

2. Obtain OAuth 2.0 Client ID and Secret.
- APIs & Services > Credentials > Create Credentials > OAuth client ID
- Select Application type: "Desktop app"

3. Set environment variables and obtain the refresh token.

bash
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.js

Note: If an error occurs when running get-refresh-token.js, execute the following command:
bash
cd google-forms-mcp
npm run build:token
node build/get-refresh-token.js

4. Copy the displayed refresh token.

5. Update the Claude desktop app's configuration file.
- Open ~/Library/Application Support/Claude/claude_desktop_config.json.
- Add environment variables to the google-forms-mcp in the mcpServers section:

json
"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"
}
}

6. Restart the Claude desktop app.


Create a form and add some questions.
``

Claude uses MCP tools like the following to create the form:

1. Use the create_form tool to create a new form
2. Use
add_text_question or add_multiple_choice_question` tools to add questions
3. Display the URL of the created form

This MCP server provides the following tools:

1. create_form - Create a new Google Form
2. add_text_question - Add a text question to the form
3. add_multiple_choice_question - Add a multiple choice question to the form
4. get_form - Get form details
5. get_form_responses - Get form responses

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "google forms mcp server": {
            "google-forms-mcp": {
                "command": "node",
                "args": [
                    "build/get-refresh-token.js"
                ]
            }
        }
    }
}

McpServers

{
    "google-forms-mcp": {
        "command": "node",
        "args": [
            "build/get-refresh-token.js"
        ]
    }
}

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

```
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.