google-drive-automation

補足資料の利用可否

このカタログの記載には、以下のインラインガイダンスが含まれていますが、次の補足パスは含まれていません。これらは外部の前提条件であり、同梱ファイルではありません。

• <support-root>/scripts/auth.py
• <support-root>/scripts/drive.py

これらのパスに依存する手順を使用する前に、元の補足資料または既存のインストール環境を求めてください。このカタログには、検証済みのダウンロード元は記載されていません。各パスはそのインストール環境を基準に解決し、内容を確認したうえで、該当するライセンスと実行上の前提条件を検証してください。必要なファイルが存在することを確認するまでは、コマンドを実行したり、参照先の手順に従ったと主張したりしないでください。見つからないスクリプトを捏造したり、同じ名前の無関係なファイルを同等のものとして扱ったりしないでください。ここにすべて記載されている独立した手順は、ユーザーが許可した範囲内で実行できます。依存する手順は利用できないものとして報告してください。

Google Drive

スタンドアロンの OAuth 認証を備えた軽量な Google Drive 連携です。MCP サーバーは不要です。完全な読み書きアクセスが可能です。

アカウントのサポートと OAuth スコープは、不足している上流スクリプトによって異なります。ログイン前に、実際の OAuth アプリケーションを確認してください。この項目は、個人の Google アカウントに対する一般的な制限を定めるものではありません。

使用する場面

• Google Drive のファイルやフォルダーを検索、一覧表示、アップロード、ダウンロード、移動、整理する必要がある場合。
• Workspace アカウントでローカルスクリプトを通じて、Drive の読み書きを直接自動化する必要がある場合。
• MCP サーバーへの依存を追加せずに、Drive のファイル単位の操作を行いたい場合。

初回セットアップ

Google で認証します（ブラウザーが開きます）。

python scripts/auth.py login

認証状態を確認します。

python scripts/auth.py status

必要に応じてログアウトします。

python scripts/auth.py logout

読み取りコマンド

すべての操作には scripts/drive.py を使用します。未ログインの場合、初回使用時に自動認証します。

# Search for files (full-text search)
python scripts/drive.py search "quarterly report"

# Search by title only
python scripts/drive.py search "title:budget"

# Search using Google Drive URL (extracts ID automatically)
python scripts/drive.py search "https://drive.google.com/drive/folders/1ABC123..."

# Search files shared with you
python scripts/drive.py search --shared-with-me

# Search with pagination
python scripts/drive.py search "report" --limit 5 --page-token "..."

# Find a folder by exact name
python scripts/drive.py find-folder "Project Documents"

# List files in root Drive
python scripts/drive.py list

# List files in a specific folder
python scripts/drive.py list 1ABC123xyz --limit 20

# Download a file
python scripts/drive.py download 1ABC123xyz ./downloads/report.pdf

スクリプトは、無関係なリポジトリの scripts/ フォルダーではなく、確認済みの <support-root> を基準に解決してください。書き込みの前に、正確なファイル ID とフォルダー ID、保存先、権限を確認してください。コンテンツの移動やゴミ箱への移動は、共同編集者に影響する可能性があります。読み取りリクエストは、変更、共有、または OAuth スコープの拡大を許可するものではありません。

書き込みコマンド

# Upload a file to Drive root
python scripts/drive.py upload ~/Documents/report.pdf

# Upload to a specific folder
python scripts/drive.py upload ~/Documents/report.pdf --folder 1ABC123xyz

# Upload with a custom name
python scripts/drive.py upload ~/Documents/report.pdf --name "Q4 Report.pdf"

# Create a new folder
python scripts/drive.py create-folder "Project Documents"

# Create a folder inside another folder
python scripts/drive.py create-folder "Attachments" --parent 1ABC123xyz

# Move a file to a different folder
python scripts/drive.py move FILE_ID DESTINATION_FOLDER_ID

# Copy a file
python scripts/drive.py copy FILE_ID
python scripts/drive.py copy FILE_ID --name "Report Copy" --folder 1ABC123xyz

# Rename a file or folder
python scripts/drive.py rename FILE_ID "New Name.pdf"

# Move a file to trash
python scripts/drive.py trash FILE_ID

検索クエリの形式

検索コマンドでは、複数のクエリ形式を使用できます。

形式	例	説明
全文	"quarterly report"	ファイルの内容と名前を検索します
タイトル	"title:budget"	ファイル名のみを検索します
URL	https://drive.google.com/...	ファイル ID またはフォルダー ID を抽出して使用します
フォルダー ID	1ABC123...	フォルダーの内容を一覧表示します（25 文字以上の ID）
ネイティブクエリ	mimeType='application/pdf'	Drive のクエリ構文をそのまま渡します

ファイル ID の形式

Google Drive では、1ABC123xyz_-abc123 のような長い ID が使用されます。ID は次の場所から取得できます。

• search の結果
• find-folder の結果
• list の結果
• Google Drive の URL

ダウンロードの制限

• 通常のファイル（PDF、画像など）は直接ダウンロードできます
• Google Docs／Sheets／Slides はこのツールではダウンロードできません
• Google Workspace ファイルには、エクスポートまたは専用ツールを使用してください

トークンの管理

上流の説明では、システムのキーリングを使用してトークンを保存します。これに依存する前に、実際の実装とフォールバック動作を確認してください。

• macOS：Keychain
• Windows：Windows Credential Locker
• Linux：Secret Service API（GNOME Keyring、KDE Wallet など）

サービス名：google-drive-skill-oauth

上流の連携では、クラウド関数による更新フローが説明されています。トークンを送信する前に、実際のスクリプトから、その運用者、送信先、スコープ、トークンの取り扱いを確認してください。Google のインフラ上でホストされているという理由だけで、Google がエンドポイントを運用していると想定しないでください。

制限事項

• このスキルは、タスクが上記の範囲に明確に合致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代わりとして扱わないでください。
• 必要な入力、権限、安全上の境界、または成功条件が不足している場合は、いったん停止して確認を求めてください。