README - mcp-server-google-forms by hosakakeigo

Google Forms MCP Server

This is a Model Context Protocol (MCP) server for Google Forms that allows you to get and update Google Forms through Claude.

[!Tip] You can also create Quiz!

Prerequisites

Node.js 20 or higher
A Google Cloud project

Setup

Enable the Google Forms API:
- Go to the Google Cloud Console API Library.
- Search for "Google Forms API".
- Select the API and click "Enable".
Configure Application Default Credentials (ADC): You have two main options for authenticating the server:

a) Using gcloud (recommended for local development):
- Install the Google Cloud CLI.
- Log in with your user credentials. By default, gcloud auth application-default login requests the following scopes: openid, https://www.googleapis.com/auth/userinfo.email, https://www.googleapis.com/auth/cloud-platform, and https://www.googleapis.com/auth/sqlservice.login.
- For this project, you must explicitly provide the necessary scopes for accessing Google Forms and Google Drive by using the --scopes flag. These will be requested in addition to the defaults (or will replace them if the gcloud version behavior is to override). The required scopes are:
```
gcloud auth application-default login --scopes=https://www.googleapis.com/auth/forms,https://www.googleapis.com/auth/drive,openid,https://www.googleapis.com/auth/userinfo.email,https://www.googleapis.com/auth/cloud-platform
```
  The drive.file scope is necessary for creating new forms, as they are stored in Google Drive. The openid and userinfo.email scopes are commonly included for user authentication context, and cloud-platform provides broad access to GCP services which might be useful if the ADC is used for other gcloud operations.
- This command will open a browser window for you to authenticate. Once done, your ADC will be configured.
- Ensure your GOOGLE_PROJECT_ID is set in your environment (see step 5). The server will use this project.
b) Using a Service Account (suitable for production or automated environments):
- Create a service account and download its key file (JSON). For more details, see Google Cloud Authentication documentation.
- Set the GOOGLE_APPLICATION_CREDENTIALS environment variable to the path of this JSON key file (see step 5).
- Ensure the service account has the necessary IAM permissions (e.g., "Forms Editor" or a custom role with equivalent permissions) and that the Forms API is enabled for your project.

Clone this repository:

git clone <repository-url> # Replace <repository-url> with the actual URL
cd <repository-name>      # Replace <repository-name> with the cloned directory name

Install dependencies:
```
pnpm install
```
Configure environment variables:
```
cp .env.example .env
```
Edit .env and set:
- GOOGLE_PROJECT_ID: Your Google Cloud project ID. This is required for both ADC methods.
- GOOGLE_APPLICATION_CREDENTIALS: Path to your service account key file.
Build the server:
```
pnpm build
```

Usage

Testing with `inspector`

$pnpm build
$pnpm dlx @modelcontextprotocol/inspector node /path/to/mcp-server-google-forms/dist/index.js

Integration with Claude for Desktop

Add the following to your claude_desktop_config.json file:

{
  "mcpServers": {
    "google-forms": {
      "command": "node",
      "args": ["/path/to/mcp-server-google-form/dist/index.js"],
      "env": {
        "GOOGLE_PROJECT_ID": "your-project-id",
        "GOOGLE_APPLICATION_CREDENTIALS": "/path/to/your/credentials.json"
      }
    }
  }
}

You may restart Claude Desktop to apply the changes.

Available Tools

create_form: Create a new Google Form
get_form: Get the structure of a Google Form
batch_update_form: Perform multiple operations on a form in a single request
- update_form_info: Update the form's basic information
- update_settings: Update form settings like email collection, quiz settings, etc.
- create_item
- delete_item
- update_item

Available Prompts

Not implemented yet.

Available Resources