Skill v1.0.0
currentLLM-judged scan95/100version: "1.0.0" name: google-drive description: | Interact with Google Drive - search files, find folders, list contents, download files, upload files, create folders, move, copy, rename, and trash files. Use when user asks to: search Google Drive, find a file/folder, list Drive contents, download or upload files, create folders, move files, or organize Drive content. Lightweight integration with standalone OAuth authentication supporting full read/write access. license: Apache-2.0 metadata: author: sanjay3290 version: "1.0"
Google Drive
Lightweight Google Drive integration with standalone OAuth authentication. No MCP server required. Full read/write access.
Requires Google Workspace account. Personal Gmail accounts are not supported.
First-Time Setup
Authenticate with Google (opens browser):
python scripts/auth.py login
Check authentication status:
python scripts/auth.py status
Logout when needed:
python scripts/auth.py logout
Read Commands
All operations via scripts/drive.py. Auto-authenticates on first use if not logged in.
# Search for files (full-text search)python scripts/drive.py search "quarterly report"# Search by title onlypython 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 youpython scripts/drive.py search --shared-with-me# Search with paginationpython scripts/drive.py search "report" --limit 5 --page-token "..."# Find a folder by exact namepython scripts/drive.py find-folder "Project Documents"# List files in root Drivepython scripts/drive.py list# List files in a specific folderpython scripts/drive.py list 1ABC123xyz --limit 20# Download a filepython scripts/drive.py download 1ABC123xyz ./downloads/report.pdf
Write Commands
# Upload a file to Drive rootpython scripts/drive.py upload ~/Documents/report.pdf# Upload to a specific folderpython scripts/drive.py upload ~/Documents/report.pdf --folder 1ABC123xyz# Upload with a custom namepython scripts/drive.py upload ~/Documents/report.pdf --name "Q4 Report.pdf"# Create a new folderpython scripts/drive.py create-folder "Project Documents"# Create a folder inside another folderpython scripts/drive.py create-folder "Attachments" --parent 1ABC123xyz# Move a file to a different folderpython scripts/drive.py move FILE_ID DESTINATION_FOLDER_ID# Copy a filepython scripts/drive.py copy FILE_IDpython scripts/drive.py copy FILE_ID --name "Report Copy" --folder 1ABC123xyz# Rename a file or folderpython scripts/drive.py rename FILE_ID "New Name.pdf"# Move a file to trashpython scripts/drive.py trash FILE_ID
Search Query Formats
The search command supports multiple query formats:
| Format | Example | Description | |
|---|---|---|---|
| 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:
searchresultsfind-folderresultslistresults- 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.