| name | gdrv-cli |
| description | Manage Google Drive files using the gdrv CLI. Use when working with file uploads, downloads, folder management, permissions, or when the user mentions Google Drive, cloud storage, file backups, or gdrv. |
Google Drive CLI
Manage Google Drive using the gdrv command-line tool.
Prerequisites
gdrv --version
export GDRV_CREDENTIALS='path/to/credentials.json'
gdrv auth login
Authentication
- Service account or OAuth2 credentials
- Environment variable:
GDRV_CREDENTIALS
- OAuth flow:
gdrv auth login
File Operations
Upload
gdrv upload file.txt --folder "Backups"
gdrv upload ./folder --recursive --folder "Archive"
Download
gdrv download FILE_ID --output ./downloads
gdrv download --query "name contains 'Report'" --output ./reports
List & Search
gdrv list --folder "Documents" --limit 100
gdrv search "*.pdf" --folder "Reports"
gdrv list --trashed
Folder Management
gdrv folder create "New Folder" --parent PARENT_ID
gdrv folder list --parent ROOT
gdrv folder delete FOLDER_ID --confirm
Permissions
gdrv share FILE_ID --email user@example.com --role editor
gdrv share FILE_ID --anyone --role viewer
gdrv permissions list FILE_ID
gdrv permissions revoke FILE_ID PERMISSION_ID
Agent Best Practices
- Use folder names when possible; resolve IDs with
gdrv list
- Recursive uploads for directory backups
- Query syntax for complex searches
- Service accounts for automation (no user interaction)
