google-drive
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
Install
npx skills add https://github.com/sanjay3290/ai-skills/tree/main/skills/google-drive
claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install sanjay3290-ai-skills@llmmart
git clone https://github.com/sanjay3290/ai-skills.git
The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole sanjay3290/ai-skills collection as a plugin from our marketplace. Git is the plain clone.
README
Google Drive Skill
An AI agent skill for interacting with Google Drive - search files, find folders, list contents, and download files. Works with Claude Code, Gemini CLI, Cursor, OpenAI Codex, Goose, and other AI clients supporting the Agent Skills Standard.
Features
- Search - Full-text search across files
- Find Folders - Locate folders by name
- List Contents - Browse folder contents
- Download - Download files locally
Read-only access. Lightweight alternative to the full Google Workspace MCP server.
⚠️ Requires Google Workspace account. Personal Gmail accounts are not supported.
Quick Start
1. Install dependencies
pip install keyring
2. Authenticate
python scripts/auth.py login
This opens a browser for Google OAuth. Tokens are stored securely in your system keyring.
3. Test connection
python scripts/auth.py status
Usage Examples
# 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
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
Command Reference
| Command | Description | Arguments |
|---|---|---|
search [query] |
Search files | query, --shared-with-me, --limit |
find-folder <name> |
Find folder by name | folder name |
list [folder_id] |
List folder contents | optional folder ID, --limit |
download <id> <path> |
Download file | file ID, local path |
Search 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 |
| Native query | mimeType='application/pdf' |
Drive query syntax |
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)
Service name: google-drive-skill-oauth
Troubleshooting
"Failed to get access token"
Run python scripts/auth.py login to authenticate.
"File not found"
Check the file ID and your access permissions.
"Cannot download Google Workspace file"
Use the dedicated skill (google-docs, google-sheets, google-slides) for Google Workspace files.
License
Apache 2.0
Skill manifest
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 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
Write Commands
# 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
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.
Files (ai-skills)
-
scripts
-
auth.py 12.4 KB
Loading… -
drive.py 19.6 KB
Loading… -
requirements.txt 16 B
Loading…
-
-
README.md 3.3 KB
# Google Drive Skill An AI agent skill for interacting with Google Drive - search files, find folders, list contents, and download files. Works with Claude Code, Gemini CLI, Cursor, OpenAI Codex, Goose, and other AI clients supporting the [Agent Skills Standard](https://agentskills.io). ## Features - **Search** - Full-text search across files - **Find Folders** - Locate folders by name - **List Contents** - Browse folder contents - **Download** - Download files locally Read-only access. Lightweight alternative to the full [Google Workspace MCP server](https://github.com/gemini-cli-extensions/workspace). > **⚠️ Requires Google Workspace account.** Personal Gmail accounts are not supported. ## Quick Start ### 1. Install dependencies ```bash pip install keyring ``` ### 2. Authenticate ```bash python scripts/auth.py login ``` This opens a browser for Google OAuth. Tokens are stored securely in your system keyring. ### 3. Test connection ```bash python scripts/auth.py status ``` ## Usage Examples ```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 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 ``` ## Command Reference | Command | Description | Arguments | |---------|-------------|-----------| | `search [query]` | Search files | query, `--shared-with-me`, `--limit` | | `find-folder <name>` | Find folder by name | folder name | | `list [folder_id]` | List folder contents | optional folder ID, `--limit` | | `download <id> <path>` | Download file | file ID, local path | ## Search 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 | | Native query | `mimeType='application/pdf'` | Drive query syntax | ## 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) Service name: `google-drive-skill-oauth` ## Troubleshooting ### "Failed to get access token" Run `python scripts/auth.py login` to authenticate. ### "File not found" Check the file ID and your access permissions. ### "Cannot download Google Workspace file" Use the dedicated skill (google-docs, google-sheets, google-slides) for Google Workspace files. ## License Apache 2.0 -
requirements.txt 16 B
Loading… -
SKILL.md 3.9 KB
--- 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): ```bash python scripts/auth.py login ``` Check authentication status: ```bash python scripts/auth.py status ``` Logout when needed: ```bash python scripts/auth.py logout ``` ## Read 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 ``` ## Write Commands ```bash # 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 ``` ## 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: - `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.
Comments (0)
Sign in to join the conversation.
Reviews (0)
No reviews yet.
No comments yet.