Google Forms MCP Server

This MCP server uses the Google Forms API to provide functions such as creating and editing forms and getting responses.

How to build

Initial Setup

After cloning the repository, install the dependencies:

Building the Server

Build the script to obtain a refresh token

Running in a development environment

How to set it up

1. Create a project in the 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 an OAuth 2.0 client ID and secret.
   • APIs and Services > Credentials > Create Credentials > OAuth Client ID
   • Application Type: Select "Desktop App"
3. Set the environment variables to get the refresh token.
   export GOOGLE_CLIENT_ID="あなたのクライアントID" export GOOGLE_CLIENT_SECRET="あなたのクライアントシークレット" cd google-forms-server npm run build node build/get-refresh-token.js
   Note: If an error occurs when running get-refresh-token.js, run the following command:
   cd google-forms-server npm run build:token node build/get-refresh-token.js
4. Copy the refresh token that is displayed.
5. Update the configuration file for Claude's desktop app.
   • Open ~/Library/Application Support/Claude/claude_desktop_config.json .
   • Add the environment variable to google-forms-server in mcpServers section: GXP7
6. Restart Claude's desktop app.

Available Tools

This MCP server provides the following tools:

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

Usage Example

Claude creates forms using MCP tools such as:

1. Create a new form using the create_form tool
2. Add questions using add_text_question and add_multiple_choice_question tools
3. View the URL of the created form