google-drive

Original：🇺🇸 English
Translated
2 scriptsChecked / no sensitive code detected

Interact with Google Drive - search files, find folders, list contents, and download files. Use when user asks to: search Google Drive, find a file/folder, list Drive contents, download a file from Drive, or browse Drive folders. Lightweight alternative to full Google Workspace MCP server with standalone OAuth authentication.

5installs
Sourcesanjay3290/ai-skills
Added on

NPX Install

npx skill4agent add sanjay3290/ai-skills google-drive

Tags

Translated version includes tags in frontmatter
google-drive-integrationoauth-authenticationfile-managementdrive-searchfile-download

SKILL.md Content

View Translation Comparison →

Google Drive

Lightweight Google Drive integration with standalone OAuth authentication. No MCP server required.
⚠️ Requires Google Workspace account. Personal Gmail accounts are not supported.

First-Time Setup

Authenticate with Google (opens browser):
bash
python scripts/auth.py login
Check authentication status:
bash
python scripts/auth.py status
Logout when needed:
bash
python scripts/auth.py logout

Commands

All operations via 
scripts/drive.py
. Auto-authenticates on first use if not logged in.
bash
# 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

Search Query Formats

The search command supports multiple query formats:
FormatExampleDescription
Full-text
"quarterly report"
Searches file contents and names
Title
"title:budget"
Searches file names only
URL
https://drive.google.com/...
Extracts and uses file/folder ID
Folder ID
1ABC123...
Lists folder contents (25+ char IDs)
Native query
mimeType='application/pdf'
Pass-through Drive query syntax

File ID Format

Google Drive uses long IDs like 
1ABC123xyz_-abc123
. Get IDs from:
  • search
    results
  • find-folder
    results
  • list
    results
  • Google Drive URLs

Download Limitations

  • Regular files (PDFs, images, etc.) download directly
  • Google Docs/Sheets/Slides cannot be downloaded via this tool
  • For Google Workspace files, use export or dedicated tools

Token Management

Tokens stored securely using the system keyring:
  • macOS: Keychain
  • Windows: Windows Credential Locker
  • Linux: Secret Service API (GNOME Keyring, KDE Wallet, etc.)
Service name: 
google-drive-skill-oauth
Automatically refreshes expired tokens using Google's cloud function.