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:

cd google-forms-server
npm install

Building the Server

# メインのMCPサーバーをビルド
npm run build

Build the script to obtain a refresh token

# リフレッシュトークン取得スクリプトをビルド
npm run build:token

Running in a development environment

# サーバーを直接実行
node build/index.js

# または、npm scriptを使用
npm run start

Related MCP server: Formswrite MCP

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