Claude Codeとスプレッドシートを連携する方法【実例付き】
「スプレッドシートの内容をClaude Codeに毎回コピペしている」
そんな使い方をしていませんか？
- シートのデータを貼り付けて質問している
- Claude Codeの作業結果を、手作業でシートに転記している
- タスク管理はシート、作業はClaude Codeで、行き来が面倒
この「コピペの往復」は、一度の設定でなくせます。
Claude Codeとは、ターミナルやIDEで動くAIエージェントです。Claudeのチャット（claude.ai）とは別物で、PC内のファイル操作やスクリプトの作成・実行まで任せられます。
このClaude CodeとスプレッドシートをAPI連携すると、シートの読み書きを直接任せられます。「シートを読んで」「この行を完了にして」と日本語で頼むだけです。
筆者は自分の作業管理シートをClaude Codeとつなぎ、タスクの確認から完了記録までを毎日この仕組みで回しています。
この記事では、Web制作・AI活用を仕事にしている筆者が、
- 連携するとできること
- 画面操作だけで進められる連携手順5ステップ
- 連携後に毎日どう使うかの実例（指示文つき）
を、プログラミング知識ゼロの方でも再現できる形で解説します。
Claude Codeとスプレッドシートの連携とは？
Claude Codeとスプレッドシートの連携とは、Claude Codeがシートを直接読み書きできる状態にすることです。その橋渡しをするのが、Googleが公式に提供する「Google Sheets API」という仕組みです。
連携が済むと、シートの内容をコピペで渡す必要がなくなります。「シートを読んで」と頼むだけで、Claude Codeが最新のデータを自分で取りに行きます。
「API」と聞くと難しそうに感じるかもしれません。ここでは「アプリ同士をつなぐ窓口」くらいの理解で十分です。設定はブラウザのクリック操作が中心で、コードを書く場面はありません。
連携するとできること4つ
連携後のClaude Codeは、スプレッドシートに対して次の4つの操作ができるようになります。
- 読む：シートの内容を読み取り、質問に答える・要約する
- 書く：作業結果や日付を、指定したセルに記録する
- 集計する：複数シートのデータをまとめて、レポートを作る
- 転記する：CSVやテキストのデータを、シートに整形して流し込む
たとえば「今月の売上シートを読んで、先月と比べて変化が大きい項目を教えて」という指示が、コピペなしで通るようになります。
さらに、連携で作ったスクリプトは定期実行への組み込みも可能です。「毎週月曜の朝にシートを集計してレポートを作る」といった自動化にも、そのままつながります。
一方で、向かない作業もあります。グラフ作成やセルの色付けといった見た目の調整は、シートの画面で直接やるほうが早く確実です。連携に任せるのは「データの読み書き・集計」と割り切るのが、うまくいく役割分担です。
筆者の使い方｜作業管理シートとつないでタスクを回す
筆者は、案件のタスクを一覧にした「作業管理シート」をClaude Codeと連携させています。
朝は「シートを読んで、未完了のタスクを期限順に教えて」から始めるのが日課です。作業が終わったら「〇〇のタスクを完了にしておいて」と伝えるだけで、シートの状態と完了日が更新されます。
どのタスクが終わっていて、どれが残っているか。その情報をClaude Code自身が把握しているので、「次にやるべき作業」の相談までできるのが便利な点です。
具体的なシート構成と指示文は、記事の後半でそのまま公開します。
連携方法は3つ｜おすすめはGoogle Sheets API
Claude Codeとスプレッドシートをつなぐ方法は、主に3つです。長く使うなら、Google Sheets API＋サービスアカウント方式をおすすめします。
まず3つの方法を比較します。
| 方法 | 初期設定 | できること | 向いている人 |
|---|---|---|---|
| ① Sheets API＋サービスアカウント | 30分ほど | 読み書き・自動実行まで対応 | 毎日の業務で使いたい人 |
| ② MCPサーバー | ツールにより異なる | 対話中の読み書き | 対話メインで使いたい人 |
| ③ CSVダウンロード | 不要 | 読み取りのみ・手動 | まず試したい人 |
① Google Sheets API＋サービスアカウント（本記事の方式）
Googleが公式に提供しているAPIを、プログラム専用のアカウント（サービスアカウント）で使う方式です。
- 追加料金なしで利用できる（Google公式）
- 一度設定すれば、読み書きも定期実行も同じ仕組みで動く
- 人間のGoogleアカウントとは別なので、権限を細かく制御できる
初期設定に30分ほどかかる点だけがハードルですが、本記事の手順どおりに進めれば迷わず設定できます。
② MCPサーバー経由
MCP（Model Context Protocol）は、Claude Codeに外部ツールを直接つなぐ仕組みです。Googleスプレッドシート用のMCPサーバーを登録すると、対話の中でシートを読み書きできます。
会話しながらシートを触る用途では手軽です。一方で、MCPは「Claude Codeとの対話中」に動く仕組みです。そのため、Claude Codeを介さない定期実行スクリプトには組み込めません。
「対話でも自動実行でも使いたい」なら、API方式のほうが応用範囲が広くなります。
③ CSVダウンロード（お試し向け）
スプレッドシートをCSV形式でダウンロードして、そのファイルをClaude Codeに読ませる方法です。
設定は一切不要なので、「連携すると何ができるか」を体感するには十分です。ただし毎回手動でダウンロードが必要で、シートへの書き込みもできません。
この記事では、長く使える①のAPI方式で手順を解説します。
なお、このほかにGAS（Google Apps Script）でシート側にプログラムを組む方法もあります。ただし、GAS側のコード管理と公開設定が別途必要です。Claude Codeとの連携が目的なら、API方式のほうがシンプルに済みます。
Claude Codeとスプレッドシートの連携手順【5ステップ】
連携の設定は5ステップ、所要時間は30分ほどです。作業はブラウザのクリック操作が中心で、コードを書く工程はありません。
必要なものは次の2つだけです。
- Googleアカウント（スプレッドシートを使っているもの）
- Claude Codeが動くPC
Claude Code自体の導入がまだの方は、先にClaude Codeとは？非エンジニア向けの業務活用法でインストールを済ませてください。
途中でわからない画面が出てきたら、その画面のスクリーンショットや文言をClaude Codeに見せて「次に何をすればいい？」と聞けます。設定作業そのものを、Claude Codeと一緒に進める感覚で大丈夫です。
STEP 1｜Google Cloudでプロジェクトを作る
まず、Google Cloud Consoleにアクセスして、普段のGoogleアカウントでログインします。
画面上部のプロジェクト選択メニューから「新しいプロジェクト」を選び、名前を付けて作成します。名前は「sheets-renkei」など、自分がわかるものであれば何でも構いません。
Google Cloudと聞くと課金が心配になりますが、Sheets APIの標準的な利用は追加料金なしで使えます。クレジットカードの登録も不要です。
※Google公式は、利用上限を超えた分について2026年後半から課金を予定していると案内しています。上限の目安は記事後半の注意点で解説しますが、個人の業務利用でまず超えることはありません。
STEP 2｜Google Sheets APIを有効にする
次に、作ったプロジェクトでSheets APIを使えるようにします。
- 左上のメニューから「APIとサービス」→「ライブラリ」を開く
- 検索窓に「Google Sheets API」と入力する
- 検索結果の「Google Sheets API」を開き、「有効にする」をクリックする
「有効にする」が「APIの管理」という表示に変われば完了です。
STEP 3｜サービスアカウントを作ってJSONキーを保存する
サービスアカウントとは、プログラム専用のGoogleアカウントです。人間の代わりに、Claude Codeが書いたスクリプトがこのアカウントとしてシートにアクセスします。
- メニューから「IAMと管理」→「サービスアカウント」を開く
- 「サービスアカウントを作成」をクリックし、名前を付ける（例：sheets-bot）
- 権限の設定画面は何も選ばず「完了」でOK
- 作成したアカウントをクリックし、「キー」タブ→「鍵を追加」→「新しい鍵を作成」を選ぶ
- 形式は「JSON」を選んで作成する
JSONファイルが自動でダウンロードされます。これが「鍵」です。
ダウンロードしたファイルは、わかりやすい場所に移しておきます。筆者はホームフォルダに「keys」フォルダを作り、credentials.jsonという名前で置いています。
このJSONファイルは、シートにアクセスできる鍵そのものです。人に送らない・公開フォルダに置かない、という扱いだけ徹底してください（詳しくは注意点の章で解説します）。
STEP 4｜スプレッドシートにサービスアカウントを招待する
ここが一番のつまずきポイントです。サービスアカウントは、シートに招待しないと中身を読めません。
- ダウンロードしたJSONファイルを開き、
client_emailの値（〜@〜.iam.gserviceaccount.com という形式のメールアドレス）をコピーする - 連携したいスプレッドシートを開き、右上の「共有」をクリックする
- コピーしたメールアドレスを貼り付け、権限を「編集者」にして送信する
操作は、同僚をシートに招待するときとまったく同じです。読み取りだけさせたい場合は、権限を「閲覧者」にすれば書き込みを防げます。
この招待を忘れると、接続テストで「403」というエラーが出ます。エラーが出たら、まずここを確認してください。
STEP 5｜Claude Codeに接続テストを依頼する
最後に、Claude Codeへ接続テストを頼みます。ここから先のコード作成は、すべてClaude Codeの仕事です。
まず、スプレッドシートのIDを控えます。IDはシートのURLの一部です。
https://docs.google.com/spreadsheets/d/【この部分がID】/editClaude Codeを起動して、次のように指示します。
Googleスプレッドシートとの連携テストをしたいです。
- 認証キー: ~/keys/credentials.json（サービスアカウントのJSONキー）
- スプレッドシートID: （控えたIDを貼り付け）
Google Sheets APIを使って、シートのA1からD5までを読み取って表示してください。
必要なライブラリのインストールも含めてお願いします。Claude Codeがスクリプトを作成・実行し、シートの中身が表示されれば連携成功です。
エラーが出た場合は、エラー文をそのままClaude Codeに貼り付ければ原因を調べて直してくれます。「403エラーならSTEP 4の招待漏れ」が最も多いパターンです。
うまくいかないときのエラー別対処法
接続テストでつまずいたときは、エラーに含まれる番号で原因を特定できます。よくあるパターンを一覧にまとめました。
| エラー | 原因 | 対処法 |
|---|---|---|
| 403 | シートにサービスアカウントを招待していない | STEP 4の共有設定をやり直す |
| 404 | スプレッドシートIDの写し間違い | URLの/d/と/editの間をコピーし直す |
| 429 | 1分あたりの利用上限を超えた | 1分待ってから再実行する |
| ファイルが見つからない | JSONキーの置き場所とパスが違う | キーの保存場所を確認して指示し直す |
どのエラーも、エラー文ごとClaude Codeに貼り付ければ対処してくれます。この表は「何が起きているか」を自分で把握するための早見表として使ってください。
実例｜作業管理シートとClaude Codeをつなぐ運用方法
ここからは、筆者が毎日使っている「作業管理シート×Claude Code」の運用をそのまま紹介します。
連携は「つないで終わり」ではなく、日々の業務でどう回すかが本番です。1つの実例として、シート構成から指示文まで公開します。
作業管理シートの構成
シートの構成はシンプルで、次の4列だけです。
| 列 | 内容 | 例 |
|---|---|---|
| A：タスク名 | 作業の名前 | 〇〇様サイト トップページ修正 |
| B：状態 | 未着手／進行中／完了 | 進行中 |
| C：期限 | 締め切り日 | 2026/07/15 |
| D：メモ | 補足・注意点 | 画像はクライアント支給待ち |
凝った仕組みは必要ありません。むしろ列がシンプルなほど、Claude Codeが読み間違えず安定して動きます。
毎日の指示はこの3パターン
運用で使う指示は、ほぼ次の3パターンに収まっています。
① 朝イチのタスク確認
作業管理シートを読んで、未完了のタスクを期限が近い順に一覧で見せてください。
今日中に終わらせるべきものがあれば教えてください。② 作業が終わったときの完了報告
「〇〇様サイト トップページ修正」を完了にしてください。
状態を「完了」に変えて、メモ欄に完了日を追記してください。③ 週次の振り返り
作業管理シートから今週完了したタスクを抜き出して、
クライアント別にまとめてください。来週に残るタスクも一覧にしてください。ポイントは、Claude Codeがタスクの完了状況を把握した状態で作業を頼めることです。
「未完了のタスクのうち、このフォルダの案件に関係するものから進めて」といった指示が通ります。シートが「Claude Codeと共有している作業台帳」になる感覚です。
CLAUDE.mdに書いておくと毎回の説明が不要になる
毎回シートIDやキーの場所を伝えるのは面倒です。そこで、CLAUDE.mdというファイルを使います。
CLAUDE.mdは、Claude Codeが起動時に自動で読み込む「申し送りメモ」です。作業フォルダに置いておくと、書いた内容を前提として動いてくれます。
筆者が書いているのは、次のような内容です。
ここまで書いておくと、毎朝の指示は「タスク確認」の一言で済みます。
最後の「確認を取る」ルールも実用上のポイントです。書き込みの前に変更内容を見せてもらうことで、想定外の上書きを防げます。
発展｜定期実行と組み合わせて朝のタスク一覧を自動化する
API連携で作ったスクリプトは、PCの定期実行機能と組み合わせられます。Macならlaunchd、Windowsならタスクスケジューラです。
たとえばClaude Codeへの指示は、次のような一文になります。
毎朝8時に作業管理シートを読み取り、未完了タスクを期限順に並べた
「今日のタスク.txt」をデスクトップに自動生成する仕組みを作ってください。スクリプトの作成から定期実行の登録まで、Claude Codeが一括で設定してくれます。
Claude Codeを起動していなくても、朝にはその日のタスク一覧がデスクトップに届いている状態です。API方式をおすすめした理由が、この「Claude Codeなしでも動く自動化」まで発展できる点にあります。
作業管理以外の活用アイデア5つ
作業管理シートは1つの例にすぎません。「シートで管理しているもの」があれば、同じ仕組みがそのまま使えます。
筆者が毎日運用しているのは前章の作業管理ですが、同じ型で実現できる応用例を紹介します。
- 経費・請求管理：レシートのテキストや請求データをシートに転記させる。「今月の経費を科目別に集計して」も一言で済む
- ブログ・SNSの投稿管理：記事タイトル・公開日・ステータスをシートで管理し、「未公開の記事一覧を見せて」と確認する
- 顧客・案件リスト：問い合わせ内容をシートに追記させ、「1ヶ月連絡していない顧客を教えて」と抽出する
- 在庫・備品管理：発注のたびにClaude Code経由で数を更新し、「残りが少ないものを一覧にして」と確認する
- アンケート・フォーム集計：Googleフォームの回答シートを読ませて、自由記述の回答を要約・分類させる
どれも仕組みは共通です。型は「シートを共有台帳にして、読み書きをClaude Codeに任せる」の1つだけ。この型さえ作れば、対象が変わっても同じ指示の仕方で回せます。
まずは自分が毎日開いているシートを1つ選んで、つないでみるのがおすすめです。
連携するときの注意点3つ
連携自体は安全に使えますが、次の3点だけは最初に押さえてください。
① JSONキーは共有・公開しない
サービスアカウントのJSONキーは、シートにアクセスできる「合鍵」です。
- チャットやメールで人に送らない
- 共有フォルダ・Webにアップロードする場所に置かない
- 「漏れたかも」と思ったら、Google Cloudの「キー」タブから削除して作り直す
キーの削除と再発行は数分で終わります。迷ったら作り直すのが安全です。
② 書き込みは、コピーしたテスト用シートで試す
読み取りと違い、書き込みはデータを書き換えます。最初の書き込みテストは、本物のシートをコピーした練習用シートで行ってください。
「ファイル」→「コピーを作成」で複製し、コピー側にもサービスアカウントを招待すれば、同じ手順でテストできます。
動きが確認できてから本物のシートに切り替えれば、大事なデータを壊す心配がありません。
③ API利用上限は通常利用ではまず超えない
Google Sheets APIには、1分あたりの利用上限があります。
- 読み取り・書き込みとも：1ユーザーあたり毎分60回、1プロジェクトあたり毎分300回（出典：Google公式 Usage limits）
1分間に60回の読み書きは、手作業の指示で到達する数字ではありません。個人〜小規模チームの業務利用なら、意識しなくて大丈夫です。
万が一超えると「429」というエラーが返りますが、1分待てば上限はリセットされます。
よくある質問
Q. プログラミング知識ゼロでも連携できますか？
A. できます。人間が行うのは、Google Cloudでのクリック操作とシートへの招待だけ。コードはすべてClaude Codeが書きます。設定中にわからない画面が出たら、その内容をClaude Codeに聞きながら進められます。
Q. 連携に料金はかかりますか？
A. 標準的な利用の範囲なら、追加料金は不要です。クレジットカード登録もいりません。なおGoogle公式は、上限を超えた分について2026年後半から課金を予定していると案内しています。上限は毎分60回の読み書きなので、通常の業務利用で超えることはまずありません。
Q. 会社のGoogleアカウント（Google Workspace）でもできますか？
A. 可能ですが、会社の設定によってはAPIの利用やサービスアカウントの作成が制限されている場合があります。うまくいかないときは、社内のシステム管理者に確認してください。
Q. Excelファイルでも同じことができますか？
A. PC内のExcelファイルなら、API設定なしでClaude Codeが直接読み書きできます。この記事の手順が必要なのは、クラウド上のGoogleスプレッドシートを扱う場合です。
Q. JSONキーを誤って共有してしまったらどうすればいいですか？
A. Google Cloudのサービスアカウント画面にある「キー」タブから、該当のキーを削除してください。削除した瞬間にそのキーは使えなくなります。新しいキーを作り直せば、数分で連携を再開できます。
まとめ
今回は、Claude CodeとGoogleスプレッドシートをAPI連携する方法を解説しました。
この記事のポイントをまとめます。
- 連携するとClaude Codeがシートを直接読み書きでき、コピペの往復がなくなる
- 連携方法は3つあり、長く使うならGoogle Sheets API＋サービスアカウント方式
- 設定は5ステップ・30分ほどで、コードはすべてClaude Codeが書いてくれる
- つまずきの大半は「シートへのサービスアカウント招待忘れ」
- CLAUDE.mdに設定とルールを書いておくと、毎日の指示が一言で済む
筆者の作業管理シートのように、シートは「Claude Codeと共有する台帳」に変わります。
まずは練習用のシートを1つ用意して、STEP 1から試してみてください。
▼ 関連記事
Web制作・AI活用のご相談はこちら
「データはあるが活用できていない」「AIを業務に取り入れたい」という方へ。
筆者はフリーランスのWebディレクターとして、Web制作とAI活用の相談を受け付けています。
まずはお気軽にお問い合わせください。
