mcpField
G
google-drive

google-drive

github.com/sanjay3290生産性447857 回インストール7 週間前に更新
リポジトリ

google-drive について

google-drive は、MCP サーバーを使わず、独立した OAuth 認証で Google Drive のファイルを操作するスキルです。Google Workspace アカウント向けで、検索、通常ファイルのダウンロード、アップロードに対応します。

主な機能

  1. 01独立した OAuth ログインとトークン更新
  2. 02全文検索とタイトル検索
  3. 03URL、フォルダー ID、ネイティブクエリでの検索
  4. 04Drive フォルダーへのファイルアップロード
  5. 05システムのキーリングによるトークン保管

活用シーン

  1. 01名前や内容によるファイル検索
  2. 02レポートの Drive へのアップロード
  3. 03フォルダー内ファイルの確認
  4. 04スクリプトからの Drive ファイル操作

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/sanjay3290/ai-skills --skill google-drive

インストール後、Claude Code で/google-driveを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

README.md
requirements.txt
scripts/
auth.py
drive.py
requirements.txt

詳細

Google Drive

スタンドアロンの OAuth 認証を使用した軽量な Google Drive 連携です。MCP サーバーは必要ありません。読み取りと書き込みの完全なアクセス権があります。

Google Workspace アカウントが必要です。 個人の Gmail アカウントには対応していません。

初回セットアップ

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

書き込みコマンド

# 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"ファイル名のみを検索します
URLhttps://drive.google.com/...ファイルまたはフォルダーの ID を抽出して使用します
フォルダー ID1ABC123...フォルダーの内容を一覧表示します（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 のクラウド関数を使用して、期限切れのトークンを自動的に更新します。

コメント

Markdown 対応