Google Forms MCP

Google Forms MCP

日本語 | Русский

A1 Google Forms MCPを使うと、AI アプリで自然な言葉を使って Google フォームを作成、管理できます。アンケートを作成し、質問を選び、準備ができたら公開して、回答を読み取り、新しい回答の通知を利用できます。

Google アカウントを使って Google Forms API と連携します。下書きフォームと公開済みフォームを区別し、すべてのフォーム操作が可能であるかのように見せることなく、Forms API の制限を明示します。

• 19 個のツール。 フォームの構造や回答を確認し、フォームや質問を作成・編集し、公開を管理して、Pub/Sub の監視を設定できます。
• 会話から接続できます。 「Google Forms に接続して」と伝えると、サーバーが OAuth クライアントの設定を案内し、PKCE を使って 127.0.0.1 への Google のリダイレクトを受け取り、トークンをサーバー内に保持します。設定ファイルも再起動も不要です。
• 意図的に公開します。 API 経由で作成したフォームは未公開の状態で始まるため、公開するまでは回答を収集できません。
• 回答はそのまま保持されます。 API では回答を読み取れますが、作成や編集はできません。サーバーには回答を送信するツールはありません。
• 最小限の Google スコープ。 広範な Drive アクセスを使わず、forms.body と forms.responses.readonly を使用します。

まずは読み取り専用の質問から始めましょう。

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

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

1 分で動作を確認

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

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

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

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

あなた： 確定。

アシスタント： フォームに質問を追加します。別途依頼されない限り、フォームを公開したり、受付を終了したりすることはありません。

目次

• クイックスタート
• 依頼できること
• フォームの変更方法
• 変更できる内容
• アクセス権の取得
• 設定
• データ、制限、バックグラウンド処理
• 技術ドキュメント
• サポート

クイックスタート

Node.js 20 以降と Google アカウントが必要です。インストール時に認証情報は不要です。サーバーは会話中に接続します。

1. AI アプリにサーバーを追加します。
2. 「connect Google Forms」と伝えると、アシスタントが設定ファイルを編集せずに、OAuth クライアントの作成とアクセスの承認を案内します。
3. 上記の読み取り専用の質問をします。

codex mcp add google-forms \
  -- npx -y mcp-google-forms@latest

codex mcp list

claude mcp add \
  --transport stdio --scope user google-forms \
  -- npx -y mcp-google-forms@latest

claude mcp list

{
  "mcpServers": {
    "google-forms": {
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"]
    }
  }
}

{
  "mcpServers": {
    "google-forms": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"]
    }
  }
}

{
  "servers": {
    "google-forms": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "mcp-google-forms@latest"]
    }
  }
}

依頼できること

アンケートと回答を確認する

• このフォームの質問、回答設定、回答者用リンクを表示する。
• 月曜日以降に届いた回答はいくつですか？自由記述のフィードバックを要約してください。
• ID を指定して回答を 1 件表示する。

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

• 氏名、食事の希望、到着日を尋ねる出欠確認フォームを作成する。
• 必須の評価、ドロップダウン、日付、時刻、選択肢、またはテキストの質問を追加する。
• 質問の順序を変更するか、タイトル、説明、クイズモード、またはメール収集の設定を更新する。

公開して通知を連携する

• 作成済みのフォームを公開し、回答者用 URL を表示する。
• フォームを削除せずに、新しい回答の受付を停止する。
• 新しい回答の通知を受け取る Cloud Pub/Sub のウォッチを作成、更新、または削除する。

フォームの仕組み

1. create_form は フォーム を作成します。フォームはデフォルトで未公開の状態です。
2. 質問は アイテム であり、フォーム内での位置によって識別されます。
3. フォームを公開すると回答者が利用できるようになります。回答の受付を終了しても公開状態は維持されますが、新しい回答は受け付けなくなります。
4. 回答は読み取り専用の別個の記録です。API では、回答者の回答を送信、編集、削除できません。

ファイルアップロードの質問は Forms API から作成できませんが、既存のファイルアップロード項目は読み取れます。Google の公開モデル導入前に作成された古いフォームでは、公開設定に対応していない場合があります。

変更内容

確認プロンプトは AI クライアントが制御します。サーバーは読み取り、書き込み、破壊的なツールにそれぞれ印を付け、クライアントが調査と実際の変更を区別できるようにします。

アクセス権の取得

Google Forms では OAuth 2.0 が必要です。API キーだけでは利用できません。アクセス方法は 2 つあり、1 つ目は設定ファイルが不要です。

チャットから接続する（推奨）

「connect Google Forms」と伝えると、アシスタントが手順を一緒に進めます。

1. setup_instructions がチェックリストを表示します。Google Cloud プロジェクトを作成または選択し、Google Forms API を有効にして、同意画面を設定し、Desktop app の OAuth クライアントを作成します。
2. そのクライアントの JSON（「Download JSON」）をダウンロードし、アシスタントにそのパスを伝えます。set_client が所有者のみアクセスできるように保存します。シークレットが会話を経由することはありません。
3. start_login が Google の同意リンクを返します。このマシン上でリンクを開いて承認すると、コードが 127.0.0.1 上の一度限りのリスナーに返されます（PKCE）。チャットを経由することはありません。
4. finish_login がコードを交換し、トークンを ~/.config/mcp-google-forms/credentials.json に保存します（モード 0600）。

トークンは呼び出しごとに読み込まれるため、接続後すぐに利用できます。AI アプリを再起動する必要はありません。auth_status で接続状況を確認でき、logout で認証を取り消して認証情報を削除できます。

環境変数（CI、無人インストール）

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

2. OAuth 同意画面を設定し、Desktop app の OAuth クライアントを作成します。

3. フォームの所有者、またはフォームを編集できる Google アカウントを認証します。OAuth 2.0 Playground では、Use your own OAuth credentials を有効にすると、リフレッシュトークンを取得できます。

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

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

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

設定

すべての変数は任意です。何も指定しない場合、サーバーはチャットから接続します。

* OAuth の 3 つの認証情報、またはアクセストークンのいずれかを指定してください。

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

• リクエストは Google Forms に送信されます。 ローカルサーバーが Google OAuth トークンを更新し、Forms API を呼び出します。匿名テレメトリに含まれるのは、インストール ID、パッケージのバージョン、AI クライアントとプラットフォームのバージョン、ツール名です。OAuth トークン、フォームデータ、ツールの引数、プロンプトは含まれません。オプトアウトするには、ASKADS_TELEMETRY=0 を設定してください。
• Google には分単位の割り当て制限があります。 公開されている上限は、プロジェクトあたりの読み取りが 975 回、list_responses の呼び出しが 450 回、書き込みが 375 回です。429 が発生すると、サーバーはバックオフを行います。読み取りではネットワークエラーと 5xx エラーの後にも再試行しますが、不確定な失敗後に書き込みを再実行することはありません。
• バックグラウンドでのポーリングはありません。 サーバーは呼び出されたときだけ実行されます。Pub/Sub の監視を使うと、新しい回答について独自のインフラストラクチャに通知できます。AI アプリがスケジュールタスクに対応している場合は、回答を定期的に確認することもできます。

技術ドキュメント

• MCP 機能カタログ — すべてのツールをタスク別に解説しています。
• すべてのツールと入力
• 開発ドキュメント
• 公開ドキュメント
• Google Forms API リファレンス

サポート

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

最後までご覧いただき、ありがとうございます！