Claudeでスプレッドシートに書き込む・連携する4つの方法

2026年3月26日

このトピックの全体像Claude Code 完全ガイド｜料金・使い方・法人導入の全体像連携・自動化の記事

公開日: 2026年3月26日最終更新: 2026年9月28日

執筆・編集：株式会社Nexa 編集部（下書きと機械検査はAI、公開前に人が確認）／約25分で読めます。公式ドキュメント・公式発表などの一次情報を確認したうえで執筆・更新しています。AIツールの仕様や料金は変わることがあるため、導入判断の前に各公式サイトの最新情報もご確認ください。記事の作り方と検査の方針

結論：ClaudeからGoogleスプレッドシートへの書き込みはできます。2026年9月27日時点で方法は4つあり、チャットで使うならClaudeアプリの公式コネクタ（ベータ）、Claude Codeで自動化するならCLIかMCPサーバーが向いています。

Claudeアプリ: Google Sheetsコネクタ（ベータ）で、チャット横の画面からシートの編集と新規作成ができる
Google公式のSheets MCPサーバー: 値の読み取り・書き込み・数式の設定・行列の挿入に対応（Developer Preview）
Claude Code: gogcliなどのCLI、またはSheets APIを呼ぶスクリプトで、セル更新・行追加・一括更新ができる

対象: 業務で使うGoogleスプレッドシートをClaudeから読み書きしたい実務担当者・DX推進担当者

今日やること: 下の比較表で自社に合う方法を1つ選び、検証用のスプレッドシートで読み取りから試す

この記事の著者

株式会社Nexa 代表取締役川島陸

一橋大学経済学部卒業後、フォーティエンスコンサルティング株式会社（旧株式会社クニエ）にて法人向けAI導入支援等を経験。独立後、AI系メディア運営やDify/n8nの導入支援を経て、株式会社Nexaを創業。法人向けAI研修・AI導入支援・AI関連メディア運営を手掛ける。

詳しく見る AI顧問の無料相談

ClaudeからGoogleスプレッドシートへの書き込みは可能です。読み取りだけでなく、セルの更新、行の追加、新しいシートの作成まで行えます。

ただし「どのClaudeを使うか」で方法が変わります。ブラウザやデスクトップアプリのClaudeなら公式コネクタ、ターミナルで動くClaude CodeならCLIやMCPサーバー、という使い分けです。

この記事では、まず4つの方法を表で比較し、そのあとClaude CodeからCLI（gogcli）で読み書きする具体的なコマンドと、GASを組み合わせた自動通知の例を紹介します。仕様は2026年9月27日にAnthropicとGoogleの公式ページを開いて確認した内容です。

ClaudeからGoogleスプレッドシートに書き込む4つの方法

2026年9月27日時点で、ClaudeからGoogleスプレッドシートを読み書きする方法は次の4つです。いずれも読み取りと書き込みの両方に対応しています。

図1: どの方法でも、Claudeへの指示からシートの読み取りと書き込みまで行える

方法	読み取り	書き込み	使う場所	主な条件	向いている用途
① Claudeアプリの公式コネクタ（Google Sheets・ベータ）	○	○（編集・新規作成）	Web版（Chrome）、デスクトップ版	Googleアカウントでの認証。Team／Enterpriseは組織のオーナーが有効化	会話しながら表を直す、集計表を新しく作る
② Google公式のSheets MCPサーバー（Developer Preview）	○	○（値・数式・行列の挿入・構造の変更）	Claude.ai／Claude Desktopのカスタムコネクタ、リモートMCPに対応したクライアント	Google Workspace Developer Preview Programへの参加、Google Cloudプロジェクト、OAuthクライアント	Google公式の接続口を使いたい、検証から始めたい
③ Claude Code＋CLI（gogcli）	○	○（セル更新・行追加・一括更新）	ターミナル（Claude Code）	自社のGoogle CloudプロジェクトでOAuthクライアントを作成。gogcliはオープンソースの外部ツール	定型の読み書き、リストの一括更新
④ Claude Code＋Sheets APIを直接呼ぶ	○	○	Pythonなどのスクリプト	サービスアカウントまたはOAuthの設定、スクリプトの保守	夜間の定期処理、既存システムへの組み込み

このほか、フォーム送信や時刻をきっかけに自動で動かしたい処理は、Google Apps Script（GAS）が担当します。Claude CodeにGASのコードを書かせ、Googleのサーバー側で動かす形です（実践事例2で紹介します）。

どれを選ぶか

チャット画面で表を直したい: ①の公式コネクタ。設定はコネクタをオンにしてGoogleアカウントを認証するだけです
Claude Codeに読み書きを任せたい: ③のCLI。Claude Codeがコマンドを実行するだけなので、作業手順に組み込みやすい方法です
毎日決まった時刻に動かしたい: ④のスクリプトか、GASの時間ベースのトリガー
Google公式の接続口にそろえたい: ②のSheets MCPサーバー。ただしDeveloper Previewのため、本番の業務に入れる前に検証が必要です

gogcliとは——Claude CodeとGoogle Workspaceをつなぐツール

gogcliは、Google WorkspaceのサービスをCLIから操作するためのオープンソースのツールです（MITライセンス）。Gmail、カレンダー、Drive、Docs、Sheets、Slides、Forms、Apps Scriptなど20以上のサービスに対応しており、OAuth認証を一度設定すればコマンドラインから扱えます。GoogleやAnthropicが提供する公式ツールではない点は、社内で導入を判断するときに押さえておいてください。

リポジトリは以前の steipete/gogcli から openclaw/gogcli に移っています。2026年9月27日時点の最新版は v0.42.0（2026年9月25日公開）です。

Claude Codeの会話内で gog sheets get などのコマンドを実行するよう指示するだけで、スプレッドシートのデータを取得・処理できます。

Sheets API直接操作との違い

Sheets APIを直接操作する場合、認証情報の管理に加えて、Pythonやシェルスクリプトを書いて保守する必要があります。gogcliを使う場合は、スクリプトを書く部分を省略できます。

比較項目	Sheets API直接操作	gogcliを使う場合
認証設定	サービスアカウントまたはOAuth設定が必要	OAuthクライアントを作成し、gogcliに登録
コード記述	Python/シェルスクリプトが必要	コマンド1行で操作可能
Claude Codeとの連携	スクリプトファイルを別途作成・管理	会話の中で直接実行指示
対応サービス	Sheetsのみ	Google Workspaceの20以上のサービスに統一対応

公式コネクタとGoogle公式MCPサーバーの現行仕様

CLIの手順に入る前に、①と②の現行仕様を整理します。公式の仕様は更新が続いており、以前の解説にある「Claudeはスプレッドシートを読めるだけで編集はできない」という説明は、現在のヘルプセンターの記載とは合いません。

Claudeアプリの公式コネクタ（ベータ）

Anthropicのヘルプセンター（Use Google Workspace connectors）には、次のように書かれています。

Google Docs・Sheets・Slidesのコネクタ（ベータ）で、チャット横の画面からファイルをその場で編集できる。利用者とClaudeが同じファイルを同時に編集できる
Google Docs・Sheets・Slidesのファイルを新しく作成できる
これらはGoogle Driveコネクタとは別のコネクタで、検索・アップロード・共有はGoogle Driveコネクタが引き続き担当する
Google Driveコネクタは、Sheets・Slides・PDF・画像・MS Officeファイルの読み取りに対応する

使い方は、チャット入力欄のプラス（＋）からコネクタを開いてSheetsをオンにし、スプレッドシートのリンクを貼るか、名前を指定して作成を依頼します。ヘルプには、Googleと明示せずに「表を作って」と頼むとローカルのファイルが作られる、という注意書きがあります。「Googleスプレッドシートで作って」と書くのが確実です。

項目	ヘルプセンターの記載（2026年9月27日確認）
対象プラン	Gmail・Googleカレンダー・Google Driveのコネクタは、ClaudeとClaude Desktopの全ユーザーが利用可能。Sheetsなどのライブ編集（ベータ）について、プランを分けた記載はない
Team／Enterprise	オーナーまたはPrimary Ownerが組織単位でコネクタを有効にしてから、各利用者が認証する
編集画面が使える環境	ChromeでのWeb版と、内蔵ブラウザをオンにしたClaude Desktop。Enterpriseプランは内蔵ブラウザが既定でオフ
権限	接続したGoogleアカウントがアクセスできるファイルだけ。既存の共有設定がそのまま適用される
承認	既定では、Claudeが行う操作ごとに利用者の承認が必要
ベータの制限	一部の機能は制限があるか、安定して動かない場合がある

なお、Claude Codeの公式ドキュメントには、claude.aiのアカウントでClaude Codeにログインしている場合、claude.aiで追加したコネクタがClaude Codeでも自動的に使えると書かれています。ただし、Sheetsのライブ編集の対応環境としてヘルプセンターが挙げているのはWeb版とデスクトップ版です。Claude Codeから確実に書き込みたい場合は、③のCLIか、次のMCPサーバーを使うのが現実的です。

Google公式のSheets MCPサーバー（Developer Preview）

Googleは、Sheets用のリモートMCPサーバーを公開しています（Configure the Sheets MCP server、最終更新2026年9月18日）。利用できるツールは次の6つです。

ツール	できること	種類
`get_values`	指定した範囲の値を取得する	読み取り
`get_spreadsheet`	シート名やグリッドの設定などのメタ情報を取得する	読み取り
`update_values`	指定した範囲に値を書き込む	書き込み
`update_formulas`	指定した範囲に数式を設定する	書き込み
`insert_dimension`	行または列を挿入する	書き込み
`update_spreadsheet`	シートの追加・削除、書式、並べ替えなどの変更をまとめて適用する	書き込み

利用の前提は、Google Workspace Developer Preview Programへの参加と、Google Cloudプロジェクトです。プロジェクトでGoogle Sheets APIとGoogle Sheets MCP APIを有効にし、OAuthの同意画面とクライアントIDを用意します。

Claude.aiまたはClaude Desktopでは、カスタムコネクタとして追加します。サーバーのURLは https://sheetsmcp.googleapis.com/mcp/v1 で、詳細設定にOAuthのクライアントIDとシークレットを入力します。Googleのガイドには、Claude.aiやClaude Desktopで使うにはEnterprise・Pro・Max・Teamのいずれかのプランが必要と書かれています。一方、Anthropicのカスタムコネクタのヘルプでは、カスタムコネクタはFreeプランでも1つまで追加できるとされています。記載に差があるため、Freeプランで試す場合は実際の画面で追加できるかを確認してください。

Claude Codeから接続する場合、Googleのガイドに個別の手順はありませんが、接続に必要な情報（URL、方式はStreamable HTTP、認証はOAuth 2.0）は示されています。Claude Codeのドキュメントの書式に当てはめると、次の形になります。

# リモートのMCPサーバーを追加（クライアントシークレットは実行後に入力）
claude mcp add --transport http --client-id <OAuthクライアントID> --client-secret --callback-port 8080 sheets https://sheetsmcp.googleapis.com/mcp/v1

OAuthクライアント側には、リダイレクト先として http://localhost:8080/callback を登録します。追加後、Claude Code内で /mcp を実行し、ブラウザでログインします。Developer Previewの機能のため、まず検証用のスプレッドシートで接続と動作を確認してください。

セットアップ：前提条件と認証の設定

ここからは、③のClaude Code＋gogcliの手順です。利用を始めるには、インストールとOAuth認証の設定が必要です。以下のコマンドは、gogcli v0.42.0時点の公式クイックスタートに沿っています。

gogcliのインストール

macOSとLinuxでは、Homebrewでインストールします。

brew install openclaw/tap/gogcli
gog --version

Windows向けの配布ファイルやDockerイメージも公式に用意されています。gogcliは単体で動くプログラムのため、Node.jsは必要ありません。

OAuth認証の設定

初回利用時にGoogle Cloudプロジェクトを作成し、OAuth 2.0クライアントIDを取得する必要があります。

手順の概要は以下の通りです。

Google Cloud Consoleでプロジェクトを作成する
「APIとサービス」→「ライブラリ」でGoogle Sheets APIを有効化する
OAuthの同意画面を設定し、種類が「デスクトップアプリ」のOAuthクライアントIDを作成して、JSONファイルをダウンロードする
ダウンロードしたJSONをgogcliに登録する
使うGoogleアカウントを認証する（ブラウザが開くので、ログインして権限を許可する）

# 手順4: OAuthクライアントを登録
gog auth credentials set ~/Downloads/client_secret_*.json

# 手順5: アカウントを認証（Sheetsだけを許可する例）
gog auth add you@example.com --services sheets

# 設定の確認
gog auth doctor --check

認証が完了すると、トークンがOSのキーチェーンなどに保存され、以降はコマンドを実行するだけで操作できます。

ポイントOAuthの同意画面が「テスト」の状態のままだと、トークンが7日で失効します。毎週の再認証を避けるには、Google Cloud Consoleの「対象」の画面でアプリを公開して「本番環境」に切り替え、gog auth add に --force-consent を付けて一度だけ認証し直します（gogcli公式クイックスタートの記載）。

スプレッドシートのIDを確認する

操作対象のスプレッドシートIDは、URLから確認できます。

https://docs.google.com/spreadsheets/d/[スプレッドシートID]/edit

この [スプレッドシートID] の部分（長い英数字の文字列）を控えておきます。以降のコマンドで使用します。

スプレッドシートの読み取り——データを取得するコマンド

認証が完了したら、スプレッドシートのデータを読み取ってみましょう。

単一セル・範囲指定の読み取り

特定のセルや範囲を読み取る基本コマンドは以下の形式です。

# 単一セルの読み取り
gog sheets get [スプレッドシートID] 'Sheet1!A1' --json

# 範囲指定の読み取り（A1からD10）
gog sheets get [スプレッドシートID] 'Sheet1!A1:D10' --json

# シート全体の読み取り
gog sheets get [スプレッドシートID] 'Sheet1' --json

--json を付けると出力がJSON形式になり、Claude Codeがその場で内容を解析・処理できます。シート名に ! が含まれるため、範囲は引用符で囲みます。

複数の範囲をまとめて取得する（batchGet）

Sheets APIには、離れた複数の範囲を1回のリクエストで取得する spreadsheets.values.batchGet があります（公式リファレンス）。マスターシートとデータシートを同時に参照したいときに、リクエスト数を抑えられます。

GET https://sheets.googleapis.com/v4/spreadsheets/[スプレッドシートID]/values:batchGet?ranges=Sheet1!A1:C10&ranges=Sheet2!A1:B20

gogcli v0.42.0のコマンド一覧には、複数範囲の値を1回で読む専用のコマンドは見当たりません。gogcliでは範囲ごとに gog sheets get を実行するか、リクエスト数を抑えたい場合はスクリプトからbatchGetを呼びます。なお、書き込み側には複数範囲を1回で更新する gog sheets batch-update があります（次の章で紹介します）。

取得したデータをClaude Codeで処理する

取得したデータはClaude Codeのコンテキストに渡され、そのまま処理できます。たとえば以下のような指示ができます。

「このKWリストの中で検索ボリュームが1,000以上のものを抽出して」
「ステータスが”未着手”のクライアントを一覧にして」
「先月の新規申し込み件数を集計して」

スプレッドシートを開かずに、Claude Codeとの会話だけでデータの確認・分析が完結します。

スプレッドシートへの書き込み——データを更新するコマンド

読み取りだけでなく、データの追加・更新もCLIから実行できます。Sheets APIの書き込みには、範囲を上書きする update、末尾に追加する append、複数範囲をまとめて更新する batchUpdate の3つがあり（Google公式ガイド）、gogcliのコマンドもこれに対応しています。

図2: 上書きはupdate、行の追加はappend、複数範囲の更新はbatch-updateを使う

特定セルの値を更新する

# 特定セルを更新
gog sheets update [スプレッドシートID] 'Sheet1!B5' "調査済み"

# 横に並んだ複数セルを更新（値はJSONの2次元配列で渡す）
gog sheets update [スプレッドシートID] 'Sheet1!B5:C5' --values-json '[["調査済み","2026-09-27"]]'

KWリストのステータス列を更新したり、クライアント情報を修正したりする際に使います。

新しい行を末尾に追加する

# 末尾に1行追加
gog sheets append [スプレッドシートID] 'Sheet1!A:D' --values-json '[["新しいKW","1000","中","未着手"]]'

このコマンドを使うと、スプレッドシートを開くことなく、新しいデータを末尾に追加できます。

複数セルを一括更新する

複数の範囲をまとめて更新するには batch-update を使います（gogcli公式の説明）。1回のリクエストで送信されるため、1件ずつ更新するよりもリクエスト数を抑えられます。

# JSON形式でまとめて更新
gog sheets batch-update [スプレッドシートID] --data-json '[{"range":"Sheet1!B2","values":[["済"]]},{"range":"Sheet1!B7","values":[["済"]]}]'

これにより、複数行にわたるステータス更新やデータ修正を1回のコマンドで完了できます。

書き込み前に確認しておく2つのオプション

--dry-run: 実際には書き込まず、送信する内容だけを表示します。Claude Codeに書き込みを任せる前の確認に使えます
--input RAW: 既定の USER_ENTERED は、画面から入力したときと同じように値を解釈します（数式は数式として、日付は日付として扱われます）。「001」のような値を文字列のまま入れたい場合は --input RAW を指定します

AI導入に関するお困りごとは、株式会社NexaのAI顧問がサポートします。「何から始めればいいか分からない」という段階からご相談いただけます。

AI顧問の無料相談はこちら →

実践事例1——KWリストをCLIから管理する

あるメディアサイトの運営者が、SEOキーワードの管理にClaude CodeとgogcliのSheets連携を活用した事例を紹介します。

KWリスト管理シートの構成

スプレッドシートには以下の列を設けていました。

列	内容
A	キーワード
B	月間検索ボリューム（Bing Webmaster API取得値）
C	競合難易度（SD）
D	優先度（高/中/低）
E	記事ステータス（未着手/執筆中/公開済）
F	公開URL

新規KWを追加するコマンド

KWリサーチで新しいキーワードが見つかった際、以下のコマンドで即座にリストへ追加していました。

gog sheets append [スプレッドシートID] 'KWリスト!A:E' --values-json '[["Claude Code 使い方","","","高","未着手"]]'

Claude Codeがリサーチ結果をまとめながら、そのままスプレッドシートへ書き込む指示を出すことで、リサーチとリスト管理が一連の作業として完結するようになりました。

調査結果を自動書き込みする

Bing Webmaster APIでボリュームを取得したあと、結果をスプレッドシートに書き戻す処理をClaude Codeが一括実行します。

# ボリューム取得結果をB列に書き込み
gog sheets update [スプレッドシートID] 'KWリスト!B5' "2400"

スプレッドシートを開かずにリサーチから管理まで完結するため、作業の切り替えコストが大幅に削減できました。

＼ AI活用の「次の一手」を一緒に考えませんか／

AI顧問の無料相談はこちら

実践事例2——Googleフォーム申し込みをスプレッドシートで管理し、GASで自動通知する

あるイベント運営者が、参加申し込みフォームとスプレッドシート・GASを連携させて自動通知を構築した事例を紹介します。

スプレッドシートの列構成をgogcliで確認する

まず、Googleフォームの回答が蓄積されているスプレッドシートの構成をClaude Codeから確認しました。

gog sheets get [スプレッドシートID] 'フォームの回答 1!A1:H1' --json

確認した結果、以下の列構成であることがわかりました。

列	内容
A	タイムスタンプ
B	お名前
C	役職
D	メールアドレス
E	電話番号
F	会社名
G	会社HPのURL
H	ご希望の日程

この情報をClaude Codeが取得した上で、GASのコードを生成する作業に進みました。

GASとclaspでフォーム送信トリガーを設定する

次に、clasp（Google公式のApps Script用CLI）を使ってGASプロジェクトを作成し、フォーム送信時のトリガーを設定しました。clasp 3系ではプロジェクト作成のコマンド名が create-script になっています。

# claspでGASプロジェクトを作成
clasp create-script --type standalone --title "フォーム自動通知"

# スクリプトをアップロード
clasp push

ポイントGASプロジェクトを既存のスプレッドシートにバインドしようとすると、別の新しいスプレッドシートが生成されてしまうことがあります。スタンドアロン型として作成し、スクリプト内でスプレッドシートIDを直接指定する方式が確実です。

管理者通知メールと申し込み確認メール下書きの自動生成

GASには以下の2つの処理を実装しました。

管理者への通知: フォーム送信ごとに管理者メールアドレスへ申し込み内容を送信
申し込み者への確認メール: 申し込み者のメールアドレスに、参加するイベントのURLを記載した確認メールの下書きを自動生成

function onFormSubmit(e) {
  const sheet = SpreadsheetApp.openById(CONFIG.SPREADSHEET_ID)
    .getSheetByName(CONFIG.SHEET_NAME);
  const lastRow = sheet.getLastRow();
  const data = sheet.getRange(lastRow, 1, 1, 8).getValues()[0];
  const name = data[1];
  const email = data[3];
  const schedule = data[7];

  // 管理者への通知メール送信
  const adminBody = `申込者: ${name}
日程: ${schedule}
シート: ${CONFIG.SPREADSHEET_URL}`;
  GmailApp.sendEmail(CONFIG.ADMIN_EMAIL, 'イベントの申し込みがありました', adminBody);

  // 申し込み者への確認メール下書き作成
  const scheduleInfo = getScheduleInfo(schedule);
  const guestBody = `${name} 様

ご参加URL: ${scheduleInfo.url}`;
  GmailApp.createDraft(email, 'お申し込みありがとうございます', guestBody);
}

// 最初に一度だけ手動で実行し、フォーム送信のトリガーを登録する
function setupTrigger() {
  ScriptApp.newTrigger('onFormSubmit')
    .forSpreadsheet(CONFIG.SPREADSHEET_ID)
    .onFormSubmit()
    .create();
}

setupTrigger 関数を一度手動で実行するだけで、以降はGoogleのサーバー側でフォーム送信を常時監視します。スプレッドシートを開きっぱなしにしたり、PCを起動しておく必要はありません。

このフローの注目点は、gogcliでスプレッドシートの列構成を確認してからGASのコードを生成したことです。列の順序が不明なままコードを書くと後から修正が必要になります。Claude Codeがgogcliで事前確認してからコード生成に進んだため、一発で正確なコードが出来上がりました。

業務で使うときの安全対策

Claudeに書き込みの権限を渡すと、データの上書きや削除も起こり得ます。業務のスプレッドシートにつなぐ前に、次の点を確認してください。

図3: 本番の管理表につなぐ前に、検証用のシートで読み取りから順に試す

検証用のシートから始める: 本番の管理表ではなく、コピーしたシートで読み取り→書き込みの順に試します
読み取り専用から始める: gogcliは --readonly を付けると、実行時に変更系のリクエストを止められます。gog auth add に付けた場合は、読み取り専用の権限だけを要求します
書き込み前に内容を確認する: --dry-run で送信内容を表示してから実行します。公式コネクタは、既定で操作ごとに承認を求めます
アカウントの権限を絞る: どの方法でも、Claudeが触れる範囲は接続したGoogleアカウントの権限と同じです。全社のファイルにアクセスできるアカウントではなく、必要なシートだけを共有したアカウントを使うと、影響範囲を限定できます
出どころの分からないシートを読ませない: Googleは、Sheets MCPサーバーのガイドで間接プロンプトインジェクション（シート内に埋め込まれた指示によってAIが意図しない操作をする攻撃）への注意を求めています。信頼できるツールだけを接続し、AIが行った操作を確認するよう案内されています
個人情報を含むシートの扱いを決める: フォームの回答のように氏名や連絡先を含むシートは、社内の情報管理ルールに照らして、Claudeに読ませてよい範囲を先に決めておきます。Anthropicのヘルプセンターには、コネクタ経由で取得したGmail・Drive・カレンダーのデータをモデルの学習に使わないこと、取得したデータはチャットとともに保存され、チャットの削除で消せることが記載されています。ただし個人向けプランで学習への利用を許可している場合、コネクタの情報を含むClaudeの応答などは学習に使われる可能性がある、という注記もあります

よくある質問

Q. ClaudeからGoogleスプレッドシートに書き込めますか？

書き込めます。Claudeアプリでは、Google Sheetsコネクタ（ベータ）でシートの編集と新規作成ができます。Claude Codeでは、gogcliなどのCLI、Sheets APIを呼ぶスクリプト、MCPサーバーのいずれかで、セルの更新・行の追加・一括更新ができます。

Q. 無料プランでも使えますか？

Anthropicのヘルプセンターでは、Gmail・Googleカレンダー・Google Driveのコネクタは全ユーザーが利用できるとされています。Sheetsのライブ編集（ベータ）については、プランを分けた記載がありません（2026年9月27日時点）。自分の画面のコネクタ一覧にSheetsが表示されるかを確認してください。Sheets API自体は、標準的な利用であれば追加費用なしで使えます。

Q. Sheets APIに料金や回数の上限はありますか？

Googleの公式ページ（Usage limits）によると、標準的な利用は追加費用なしです。上限は1分あたりで決まっており、読み取り・書き込みそれぞれ、プロジェクトあたり300回、利用者あたり60回です。1日あたりの回数制限はありません。上限を超えると「429: Too many requests」が返ります。このほか、1回のリクエストは2MB以下が推奨され、処理に180秒を超えるとタイムアウトになります。

項目	上限（2026年9月27日確認）
読み取り（プロジェクトあたり）	1分あたり300回
読み取り（利用者あたり）	1分あたり60回
書き込み（プロジェクトあたり）	1分あたり300回
書き込み（利用者あたり）	1分あたり60回
1日あたりの回数	制限なし（1分あたりの上限内であれば）
1リクエストの処理時間	180秒を超えるとタイムアウト

なお同ページには、上限を超えた分について2026年後半から課金を予定している旨の記載があります。大量のリクエストを送る処理を組む場合は、最新の記載を確認してください。

Q. gogcliがエラーになるときの対処法は？

よくあるエラーには次のものがあります。

「認証エラー」が出る場合: まず gog auth doctor --check で状態を確認します。OAuthの同意画面が「テスト」のままだと、トークンが7日で失効します。gog auth add で認証し直し、繰り返す場合は同意画面を「本番環境」に切り替えてください。

「スプレッドシートが見つからない」場合: スプレッドシートIDの確認と、認証しているGoogleアカウントがそのスプレッドシートにアクセス権を持っているかを確認してください。

「APIクォータ超過」エラーが出る場合: Sheets APIには1分あたりのリクエスト数に上限があります。短時間に多数のコマンドを実行する場合は、batch-update で書き込みをまとめ、読み取りは範囲を広めに取って回数を減らしてください。

Q. スプレッドシートの全シートを一括で取得できますか？

シート名の一覧などのメタ情報は、gog sheets metadata [スプレッドシートID] で取得できます。全シートのデータを取得する場合は、まずメタ情報でシート名を確認し、シートごとに gog sheets get を実行する方法が確実です。

Q. gogcliをMCPサーバーとして使うことはできますか？

できます。gogcliには gog mcp というコマンドがあり、MCPサーバーとして起動できます（公式の説明）。既定では読み取り用のツールだけが有効で、Sheetsの範囲を読む sheets_read_range が使えます。書き込み用の sheets_update_range は、起動時に --allow-write を付けた場合だけ有効になります。古い版には含まれないため、gog --version で版を確認してください。

Q. GASトリガーとgogcliはどちらを使うべきですか？

用途によって使い分けます。

用途	推奨方法
スプレッドシートのデータを確認・分析したい	gogcli（Claude Codeから即時確認）
フォーム送信・行追加などのイベントに自動で反応したい	GAS（Googleサーバー側で常時監視）
定期的にデータを更新・集計したい	GAS（時間ベーストリガー）またはcron