mcp-server-google-forms

Name: mcp-server-google-forms
Author: claude-book

ローカル

github.com/claude-book生産性012 週間前に更新

リポジトリ

mcp-server-google-forms について

Claude Code向けのローカルMCPサーバーで、Google Formsの作成、編集、公開、回答の取得ができます。クイズ、セクション、解答の検証に対応し、ブラウザーでGoogleアカウントを認証します。

主な機能

01一度の操作でフォーム全体を作成
029種類の質問を追加・編集
03クイズモードと解答を管理
04セクションと説明文を挿入
05フォームの公開・非公開を切替
06回答一覧と認証情報を確認

活用シーン

01問題と配点を含むクイズの作成
02既存の回答を保持したフォーム編集
03長いフォームをセクションで整理
04回答の確認やクイズ解答の監査

MCP 対応

フォームの作成、編集、公開、回答取得、認証診断など、15個のGoogle FormsツールをMCPクライアントに提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "claude-book-mcp-server-google-forms": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-server-google-forms"
      ],
      "env": {
        "GOOGLE_FORMS_MCP_DIR": "<GOOGLE_FORMS_MCP_DIR>"
      }
    }
  }
}

起動コマンドnpx -y mcp-server-google-forms

設定が必要な環境変数

GOOGLE_FORMS_MCP_DIRPasta com as credenciais do Google (client_secret*.json e config.json). Opcional — padrão: ~/.config/mcp-server-google-forms/

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npmmcp-server-google-forms0.5.0stdio

ツール

掲載時のツール一覧 · 3 週間前に更新

パラメーター	型	必須	説明
title	string	はい	回答者に表示されるフォームのタイトル
unpublished	boolean	いいえ	下書きとして作成する場合は true（set_publish まで回答できません）。デフォルト：公開済み。
documentTitle	string	いいえ	Drive 内のファイル名（任意）

詳細

mcp-server-google-forms

Claude Code で Google Forms を作成、編集、公開できるローカル MCP サーバーです。ユーザーには **「Forms IA (MCP)」**という名前で表示される、Google によって検証済みのアプリです。 Claude Code に関する書籍のサンプルコードです。

✅ 簡単に使えます： Google Cloud で何かを作成したり、認証情報ファイルをダウンロードしたりする必要はありません。インストールして Google アカウントでログインするだけで使えます（警告のない、すっきりした画面です）。また、カード形式のページもあります。こちらのほうが読みやすいかもしれません。

クイックスタート

Node.js 18 以降、Claude Code、Google アカウントをお持ちですか？それならコマンドは2つです。

# 1. Autorize com o Google (o navegador abre; app verificado, sem avisos)
npx -p mcp-server-google-forms mcp-server-google-forms-token

# 2. Registre no Claude Code
claude mcp add google-forms -- npx mcp-server-google-forms

プログラミングをしない方向けの詳しい手順が必要ですか？以下のガイドをご覧ください。👇

プログラミングをしない方向けの完全ガイド

前提条件

Node.js 18 以降。 サーバーを動かすプログラムです。npm と npx コマンドも一緒にインストールされます。確認するには、ターミナルを開き（下記参照）、node --version と入力してください。v18… 以上が表示されれば準備完了です。そうでない場合は、nodejs.org から LTS バージョンをダウンロードしてインストールしてください（「次へ」をクリックしていくだけです）。
Claude Code がインストールされていること — サーバーとのやり取りに使用します（code.claude.com/docs）。
Google アカウント（フォームを作成するアカウント）。

ターミナルの開き方（ここにコマンドを貼り付けます）：

Windows： スタートメニュー → PowerShell と入力 → Windows PowerShell を開きます。
Mac： Cmd + スペースを押し、Terminal と入力して Enter を押します。
Linux： アプリケーションメニューで Terminal を探します（または Ctrl + Alt + T）。

💡 このガイドで「コマンド X を実行する」とある場合は、必ずターミナルを開き、X を貼り付けて Enter を押してください。

手順1 — Google アカウントを認証する

認証コマンドを実行します：
```
npx -p mcp-server-google-forms mcp-server-google-forms-token
```
Google のログイン画面がブラウザーで自動的に開きます。
アカウントにログインして、アクセスを許可します。 画面には Forms IA (MCP) アプリが表示されます。Google によって検証済みのため、セキュリティ警告はありません。権限（フォームの作成／編集と回答の読み取り）を確認し、続行／許可をクリックしてください。ターミナルに 「完了。refreshToken を保存しました…」 と表示されれば成功です。

手順2 — Claude Code に登録する

claude mcp add google-forms -- npx mcp-server-google-forms

手順3 — Claude に依頼する

これで準備完了です！Claude Code を開いて、たとえば次のように依頼してください。

「光合成について、各2点の5問のクイズを作成して、共有用のリンクを教えてください。」

一般的な流れ：build_form（または create_form → add_question）→ 回答用リンクを共有 → list_responses。

公開について： 実際に確認したところ（2026年7月10日）、Google のドキュメントの説明とは異なり、API はデフォルトでフォームを公開済みの状態で作成します。そのため、作成ツールでは unpublished=true（下書きとして作成）を指定でき、API が返す実際の状態も通知します。また、set_publish では公開と非公開の両方を設定できます。

別のコンピューターで使う

新しいマシンで手順 1 と 2 を繰り返すだけです。ファイルも設定も必要ありません。再ログインしたくない場合は、古いコンピューターの ~/.config/mcp-server-google-forms/ フォルダー（Windows の場合は C:\Users\SeuNome\.config\mcp-server-google-forms\）を、新しいコンピューターの同じ場所にコピーしてください。中にある config.json に認証情報が保存されています。

🤔 なぜこのフォルダーは「隠し」フォルダーなのですか？

パスはドット（.config）で始まるため、Windows のエクスプローラーにも Mac の Finder にも、フォルダーは標準では表示されません。これは意図的なものです。プログラムは設定を ~/.config にまとめて保存します（~ はユーザーフォルダーを表します）。書類が散らからないよう、目につかない場所に置かれています。「隠し」は「保護されている」という意味ではありません。このフォルダーはいつでも開けます。パスをエクスプローラーのアドレスバーに貼り付けるか、Finder で Cmd + Shift + G を使ってください。サーバーはここに認証情報（config.json）を保存します。

💻 リポジトリのクローンをお考えですか？（コードを変更する場合）

クローンしてインストールします：

git clone https://github.com/claude-book/mcp-server-google-forms.git
cd mcp-server-google-forms
npm install

認証します： npm run token を実行し、ブラウザーで承認します。
Claude Code に登録します（プロジェクトのルートで実行）：
```
claude mcp add google-forms -- node "$(pwd)/src/server.js"
```

ツール（15）

ツール	機能
`create_form`	フォームを作成し、ID とリンクを返します。Google は標準で公開済みの状態で作成します。下書きにするには `unpublished=true` を指定してください。応答には実際の状態が記載されます。
`build_form`	タイトル、説明、クイズモード、すべての質問を含むフォーム全体を1 回の操作で作成します。
`set_publish`	フォームを公開または非公開にします（回答を受け付ける、またはブロックします）。
`get_form`	項目の一覧を位置と完全な構造とともに表示します。
`add_question`	質問を末尾または指定した位置に追加します。9 種類に対応しています：短文／長文、単一選択、チェックボックス、プルダウン、線形スケール、日付、時刻／所要時間、評価（星、ハート、いいね）。
`update_form_info`	既存のフォームのタイトルや説明を変更します。
`update_question`	既存の質問（質問文、必須設定、選択肢、点数、正解）を削除して作り直すことなく編集します。これにより、すでに受け取った回答との関連付けが維持されます。
`set_quiz`	クイズモード（採点機能付き）をオンまたはオフにします。`points` を使用する前に必ず有効にしてください。
`add_section`	指定した位置にセクション区切り（新しいページ）を挿入します。
`add_text_item`	指定した位置に説明テキストのブロック（回答欄なし）を挿入します。
`delete_question`	指定した位置の質問を削除します（質問以外の項目は削除できません）。
`move_question`	項目をある位置から別の位置へ移動します。
`list_responses`	ファイルアップロードの質問を含む回答を一覧表示します。ページ単位（標準は 50 件）で、`pageSize`／`pageToken` を指定できます。
`verify_answer_keys`	クイズの正解を期待される一覧と照合します（作成後の監査）。
`auth_status`	認証情報を診断します。ファイルの有無、必須項目の入力状況、Google への実際の接続テストを確認します。

トラブルシューティング

「認証情報の期限切れまたは失効」 — 認証コマンドを再度実行（手順 1）して、ログインし直してください。サーバーは再起動しなくても認証情報を自動で再読み込みします。
認証時にブラウザーが開きませんでしたか？ — ターミナルにも URL が表示されます。コピーしてブラウザーに貼り付けてください。
Google Cloud の独自プロジェクトを使っていますか？このケース特有の問題については、下のセクションをご覧ください。

簡単に診断するには、Claude に auth_status ツールを実行するよう依頼してください。このツールは Google への接続を直接テストします。

Google Cloud の独自プロジェクトを使用する（上級者向け）

デフォルトでは、認可には Google が検証した Forms IA (MCP) アプリの組み込み認証情報を使用します。認可とデータは引き続きご自身のアカウントとマシン内にのみ保存されます（詳細は src/default-client.js を参照）。 ご自身のプロジェクトを使用したい場合（たとえば、ご自身の割り当てを利用するため）、認証情報フォルダー内の client_secret*.json が組み込み認証情報より優先されます。

独自プロジェクトの設定手順

console.cloud.google.com で、プロジェクトを作成 → Google Forms API を有効化 → OAuth 同意画面（外部）を設定 → 自分をテストユーザーとして追加（追加しないと、認可時に「アクセス拒否」になります）→ 認証情報を作成（OAuth クライアント ID、種類は デスクトップアプリ）。
作成時に JSON をダウンロードしてください。Google では後からダウンロードできません（紛失した場合は、別のクライアントを作成してください）。
client_secret*.json を ~/.config/mcp-server-google-forms/（Windows: C:\Users\SeuNome\.config\mcp-server-google-forms\）に配置します。クローンからインストールした場合は、credentials/ に配置します。
認可コマンドを実行します。ターミナルに 「ご自身の Google Cloud プロジェクトを使用しています」 と表示されます。

独自プロジェクトでのみ表示される警告：

「Google はこのアプリを確認していません」 — 正常です（アプリはご自身のものです）。**詳細設定 → … にアクセス（安全ではありません）**をクリックしてください。
「アクセス拒否」 / access_denied — テストユーザーとして自分を追加していません。OAuth 同意画面に戻ってください。
7 日後の有効期限切れ — テスト中モードでは、Google によって認可が 7 日ごとに期限切れになります。アプリを公開すると解決します（OAuth 同意画面 → アプリを公開）。個人利用の場合、審査を受ける必要はありません。

技術リファレンス

フォルダー構成

src/server.js           → o servidor MCP
src/default-client.js   → credencial OAuth padrão (app verificado; pública por design)
src/credentials-dir.js  → resolução da pasta de credenciais
scripts/get-token.js    → autorização OAuth (rodar uma vez)
credentials/            → segredos locais (config.json e, opcionalmente, client_secret*.json) — fora do git
docs/                   → site do projeto (GitHub Pages)

認証情報の保存場所

サーバーと認可スクリプトは、次の順序で認証情報を探します。

環境変数 GOOGLE_FORMS_MCP_DIR で指定されたフォルダー（設定されている場合）；
プロジェクト内の credentials/（クローンからインストールした場合にフォルダーが存在します）；
~/.config/mcp-server-google-forms/（npm/npx 経由でインストールした場合）。

認可時には、フォルダー内に client_secret*.json があれば、それが優先されます。ない場合は、検証済みアプリの組み込み認証情報（src/default-client.js）が使用されます。

機密ファイル

本当に秘密にすべきなのは config.json（refresh token を保存）です。これはマシンの外に出ることはなく、クローンの credentials/ フォルダーは .gitignore に含まれています。組み込み認証情報（src/default-client.js）は デスクトップタイプの OAuth クライアントのもので、Google はこれを秘密ではないものとして扱います（rclone/gcloud モデル）。フローの安全性は、この値の秘匿ではなく、ブラウザーでのユーザーの同意によって確保されます。

ドキュメント

プロジェクトページ — 概要、プライバシーポリシー、利用規約。
作者のドメインにあるアプリのページ — Forms IA (MCP) のホーム、プライバシー、利用規約。
コードレビュー — 既知の問題、重大度、修正状況、および変更理由を含む変更履歴。
類似 MCP の調査 — GitHub 上の Google Forms 向け MCP サーバー 7 件との比較、採用した改善点、避けるべきアンチパターン。
HTML 版 — プログラマー以外にも読みやすい形式の同じレポートです（ブラウザーで開いてください）。

引用

このソフトウェアには恒久的な DOI があります（各リリースでZenodoにアーカイブされます。メタデータはCITATION.cffにあります）。

Alvarenga da Silva, H. (2026). mcp-server-google-forms: Google Forms 用 MCP サーバー. Zenodo. https://doi.org/10.5281/zenodo.21296975

ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

作者: claude-book
言語: node
バージョン: 0.5.0
トランスポート: stdio
掲載日: 2026年7月10日
最終更新: 12 週間前
公式 Registry: io.github.claude-book/mcp-server-google-forms

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

mcp-server-google-forms

mcp-server-google-forms について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

mcp-server-google-forms

目次

クイックスタート

プログラミングをしない方向けの完全ガイド

前提条件

手順1 — Google アカウントを認証する

手順2 — Claude Code に登録する

手順3 — Claude に依頼する

別のコンピューターで使う

ツール（15）

トラブルシューティング

Google Cloud の独自プロジェクトを使用する（上級者向け）

技術リファレンス

ドキュメント

引用

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？