📋

Claude Codeなどに非公開のGoogle Spreadsheet/Docsをコンテキストとして楽にいれる

に公開
2026/01/21

概要

Google Cloud の gcloud コマンドを使って、自分がアクセス権を持つ Google Spreadsheet / Google Docs の内容を CLI から取得する方法です。

TL;DR

# Spreadsheet (CSV)
curl -sL "https://docs.google.com/spreadsheets/d/${SPREADSHEET_ID}/export?format=csv&gid=${GID}" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)"

# Docs (Markdown)
curl -s "https://www.googleapis.com/drive/v3/files/${DOCUMENT_ID}/export?mimeType=text/markdown" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)"

手順

1. gcloud CLI のインストール

macOS

brew install --cask google-cloud-sdk

その他のOS

公式ドキュメントを参照してください。

2. Google アカウントでログイン

gcloud auth login

ブラウザが開くので、Google アカウントでログインしてください。

3. プロジェクトの作成

gcloud projects create "gdrive-api-$(openssl rand -hex 4)" --name="Google Drive API"

ランダムな文字列が付与されたプロジェクト(例:gdrive-api-4f51686d)が作成されます。
Google Cloud全体で一意である必要があるため、例ではランダムな文字列を生成させてますが、好みで変えてください。

4. プロジェクトの設定

作成したプロジェクトを使用するように設定します。

gcloud config set project gdrive-api-xxxxxxxx

gdrive-api-xxxxxxxx は手順3で作成されたプロジェクトIDに置き換えてください。

5. Google Drive へのアクセス権限を付与

gcloud auth login --enable-gdrive-access

再度ブラウザが開くので、アクセスを許可してください。

6. スプレッドシートの取得

curl -s "https://sheets.googleapis.com/v4/spreadsheets/{SPREADSHEET_ID}/values/{SHEET_NAME}" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" | jq

パラメータ:

  • SPREADSHEET_ID: スプレッドシートのURLから取得
    https://docs.google.com/spreadsheets/d/【ここがID】/edit
  • SHEET_NAME: シート名(タブ名)

シート名を確認する

curl -s "https://sheets.googleapis.com/v4/spreadsheets/{SPREADSHEET_ID}" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" | jq '.sheets[].properties.title'

範囲を指定して取得

# A1からD10までを取得
curl -s "https://sheets.googleapis.com/v4/spreadsheets/{SPREADSHEET_ID}/values/{SHEET_NAME}\!A1:D10" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" | jq

CSV形式でエクスポート

LLMに食わせる場合など、CSV形式が便利です。

curl -sL "https://docs.google.com/spreadsheets/d/{SPREADSHEET_ID}/export?format=csv" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)"

特定のシートを指定するには gid パラメータを追加:

curl -sL "https://docs.google.com/spreadsheets/d/{SPREADSHEET_ID}/export?format=csv&gid={GID}" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)"

パラメータ:

  • GID: シートのID(URLの #gid=xxx の部分)

7. Google Docs の取得

curl -s "https://docs.googleapis.com/v1/documents/{DOCUMENT_ID}" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" | jq

パラメータ:

  • DOCUMENT_ID: ドキュメントのURLから取得
    https://docs.google.com/document/d/【ここがID】/edit

テキスト部分だけ抽出

curl -s "https://docs.googleapis.com/v1/documents/{DOCUMENT_ID}" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)" | jq -r '.body.content[].paragraph?.elements[]?.textRun?.content // empty'

Markdown形式でエクスポート

curl -s "https://www.googleapis.com/drive/v3/files/{DOCUMENT_ID}/export?mimeType=text/markdown" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)"

HTML形式でエクスポート

curl -s "https://www.googleapis.com/drive/v3/files/{DOCUMENT_ID}/export?mimeType=text/html" \
  -H "Authorization: Bearer $(gcloud auth print-access-token)"

補足

  • この方法は自分がアクセス権を持つファイルのみ取得可能です
  • あとはお好みでSkillsとかに書いてください

おまけ。導入するprompt例

以下の記事を参考に、user単位のClaude Code skillsを作成してください。

記事: https://zenn.dev/ux_xu/articles/2d171a94f32c60

要件:
- 公式のベストプラクティス(https://platform.claude.com/docs/en/agents-and-tools/agent-skills/best-practices)に従う
- ~/.claude/skills/ に配置

FYI

https://developers.google.com/workspace/sheets/api/reference/rest?hl=ja
https://developers.google.com/docs/api/reference/rest?hl=ja
https://developers.google.com/workspace/drive/api/reference/rest/v3?hl=ja

ユカイ工学テックブログ

Discussion