Google Forms MCP

英語 | ロシア語

A1 Google Forms MCP は、AIアプリが平易な言葉でGoogle Formsを作成・管理できるようにします。アンケートを作成し、質問を選び、準備ができたら公開し、回答を読み取り、新しい回答の通知を利用できます。

これは、あなたのGoogleアカウントでGoogle Forms APIを使用します。下書きフォームと公開済みフォームを区別し、あらゆるフォーム操作が可能であるかのように示唆するのではなく、Forms APIの制限を明示します。

• 13のツール。 フォーム構造と回答を検査し、フォームと質問を作成・編集し、公開を管理し、Pub/Subウォッチを設定できます。

• 意図的な公開。 APIを通じて作成されたフォームは未公開で始まるため、公開するまで回答を収集できません。

• 回答はそのまま保持されます。 APIは回答を読み取れますが、回答の作成や編集はできません。サーバーには回答を送信するツールはありません。

• 最小限のGoogleスコープ。 forms.body と forms.responses.readonly を使用し、広範なDriveアクセスは行いません。

顧客フィードバックフォームへの昨日の回答を見せて、自由記述の回答を要約してください。

サーバーに接続する · ユースケースを見る · 技術ドキュメントを開く

1分で動作を確認する

あなた： 顧客フィードバックフォームの質問と回答設定を見せてください。

アシスタント： フォーム、その項目、公開されているかどうか、回答を受け付けているかどうかを表示します。何も変更しません。

あなた： 最初の質問の後に、「ご体験はいかがでしたか？」という必須の1〜5評価質問を準備してください。

アシスタント： 対象のフォーム、位置、提案した質問を表示し、追加する前に確認を求めます。

あなた： 確認してください。

アシスタント： 質問をフォームに追加します。個別に依頼しない限り、フォームを公開したり閉じたりしません。

Related MCP server: Google Workspace MCP Server

目次

• クイックスタート

• 何を依頼できるか

• フォームがどう変わるか

• 変更できること

• アクセス権の取得

• 設定

• データ、制限、バックグラウンド処理

• 技術ドキュメント

• サポート

クイックスタート

Node.js 20以上、Googleアカウント、およびGoogle Forms APIが有効なGoogle CloudプロジェクトのOAuth認証情報が必要です。

1. Google OAuthアクセスを準備します。

2. AIアプリにサーバーを追加します。

3. 上記の読み取り専用の質問を依頼してください。

アプリ内： 設定 → プラグイン → MCPサーバー を開き、サーバーを追加 を選択して、npx -y mcp-google-forms@latest を GOOGLE_FORMS_CLIENT_ID、GOOGLE_FORMS_CLIENT_SECRET、GOOGLE_FORMS_REFRESH_TOKEN とともに追加します。

コマンドラインから：

codex mcp add google-forms \
  --env GOOGLE_FORMS_CLIENT_ID=your_client_id \
  --env GOOGLE_FORMS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_FORMS_REFRESH_TOKEN=your_refresh_token \
  -- npx -y mcp-google-forms@latest

codex mcp list

Codex MCPドキュメント

claude mcp add \
  --env GOOGLE_FORMS_CLIENT_ID=your_client_id \
  --env GOOGLE_FORMS_CLIENT_SECRET=your_client_secret \
  --env GOOGLE_FORMS_REFRESH_TOKEN=your_refresh_token \
  --transport stdio --scope user google-forms \
  -- npx -y mcp-google-forms@latest

claude mcp list

Claude Code MCPドキュメント

設定 → 開発者 → 設定を編集 を開き、以下を追加します：

{
  "mcpServers": {
    "google-forms": {
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"],
      "env": {
        "GOOGLE_FORMS_CLIENT_ID": "your_client_id",
        "GOOGLE_FORMS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_FORMS_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

設定を編集 が利用できない場合は、macOSでは ~/Library/Application Support/Claude/claude_desktop_config.json、Windowsでは %APPDATA%\Claude\claude_desktop_config.json を編集します。

Claude Desktop MCPドキュメント

macOS/Linuxでは ~/.cursor/mcp.json に、Windowsでは %USERPROFILE%\.cursor\mcp.json に以下を追加します：

{
  "mcpServers": {
    "google-forms": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"],
      "env": {
        "GOOGLE_FORMS_CLIENT_ID": "your_client_id",
        "GOOGLE_FORMS_CLIENT_SECRET": "your_client_secret",
        "GOOGLE_FORMS_REFRESH_TOKEN": "your_refresh_token"
      }
    }
  }
}

Cursor MCPドキュメント

MCP: Open User Configuration を実行し、以下を追加します：

{
  "servers": {
    "google-forms": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"],
      "env": {
        "GOOGLE_FORMS_CLIENT_ID": "${input:forms_client_id}",
        "GOOGLE_FORMS_CLIENT_SECRET": "${input:forms_client_secret}",
        "GOOGLE_FORMS_REFRESH_TOKEN": "${input:forms_refresh_token}"
      }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "forms_client_id", "description": "Google OAuth client ID" },
    { "type": "promptString", "id": "forms_client_secret", "description": "Google OAuth client secret", "password": true },
    { "type": "promptString", "id": "forms_refresh_token", "description": "Google OAuth refresh token", "password": true }
  ]
}

MCP: List Servers で確認します。

VS Code MCPドキュメント

何を依頼できるか

アンケートとその回答を調べる

• このフォームの質問、回答設定、回答者リンクを表示する。

• 月曜日から何件の回答が届きましたか？自由記述のフィードバックを要約してください。

• IDを指定して1件の回答を表示する。

フォームを作成・改善する

• 名前、食事の好み、到着日を含むRSVPフォームを作成する。

• 必須の評価、ドロップダウン、日付、時刻、選択肢、テキストの質問を追加する。

• 質問を並べ替えたり、タイトル、説明、クイズモード、メールアドレス収集を更新したりする。

公開と通知の接続

• 準備したフォームを公開し、回答者用URLを表示する。

• フォームを削除せずに新しい回答の受け付けを停止する。

• 新しい回答に対するCloud Pub/Subウォッチを作成、更新、または削除する。

フォームがどう変わるか

1. create_form はフォームを作成します。このフォームは既定では未公開で開始します。

2. 質問は項目であり、フォーム内の位置によって識別されます。

3. 公開すると、回答者がフォームを利用できるようになります。回答の収集を停止してもフォームは公開されたままですが、新しい回答は受け付けなくなります。

4. 回答は独立した読み取り専用のレコードです。APIは回答者の回答を送信、編集、削除できません。

ファイルアップロードの質問はForms APIでは作成できませんが、既存のファイルアップロード項目は読み取ることができます。Googleの公開モデルより前に作成されたレガシーフォームでは、公開設定がサポートされない場合があります。

変更できること

AIクライアントが確認プロンプトを制御します。サーバーは読み取り、書き込み、破壊的なツールをマークするため、クライアントは調査（読み取り）と実際の変更を区別できます。

アクセス権の取得

Google FormsではOAuth 2.0が必要です。APIキーだけでは不十分です。

1. Google Cloudプロジェクトを作成または選択し、Google Forms APIを有効にします。

2. OAuth同意画面を設定し、デスクトップアプリのOAuthクライアントを作成します。

3. フォームを所有している、または編集できるGoogleアカウントを承認します。OAuth 2.0 Playgroundは、独自のOAuth認証情報を使用が有効になっている場合、リフレッシュトークンを取得できます。

4. 両方のスコープをリクエストします：

   https://www.googleapis.com/auth/forms.body
   https://www.googleapis.com/auth/forms.responses.readonly

テストモードのOAuthリフレッシュトークンは7日後に失効することがあります。長期間のアクセスが必要な場合は、OAuthアプリを公開するか、Workspaceドメインで内部アプリを使用してください。クライアントシークレットとリフレッシュトークンはパスワードとして扱ってください。

設定

* OAuth 3点セットまたはアクセストークンのいずれかを指定します。

データ、制限、バックグラウンド処理

• リクエストはGoogle Formsに送信されます。 ローカルサーバーはGoogle OAuthトークンを更新し、Forms APIを呼び出します。その匿名テレメトリには、インストールID、パッケージバージョン、AIクライアントとプラットフォームのバージョン、ツール名が含まれます。OAuthトークン、フォームデータ、ツールの引数、プロンプトが含まれることは決してありません。オプトアウトするには ASKADS_TELEMETRY=0 を設定します。

• Googleは1分あたりのクォータを適用します。 ドキュメント化されている制限は、プロジェクトごとに読み取り975回、list_responses 呼び出し450回、書き込み375回です。429 の場合はサーバーがバックオフを使用します。読み取りはネットワークエラーや 5xx エラーの後にも再試行されますが、書き込みは不確実な障害の後に再実行されることはありません。

• バックグラウンドでのポーリングはありません。 サーバーは呼び出されたときだけ実行されます。Pub/Subウォッチは、新しい回答について独自のインフラストラクチャに通知できます。AIアプリがスケジュールタスクをサポートしている場合は、定期的に回答を確認することもできます。

技術ドキュメント

• MCP機能カタログ — すべてのツールのタスク指向ページ。

• すべてのツールと入力

• 開発ドキュメント

• 公開ドキュメント

• Google Forms APIリファレンス

サポート

バグを見つけた場合やシナリオが必要な場合は、イシューを作成 するか、Telegram でご連絡ください。