🎯

google-drive

🎯Skill

from sanjay3290/ai-skills

What it does

Searches, finds, lists, and downloads files from Google Drive using standalone OAuth authentication for Google Workspace accounts.

📦

Part of

sanjay3290/ai-skills(17 items)

google-drive

Installation

PythonRun Python server

python scripts/auth.py login

PythonRun Python server

python scripts/auth.py status

PythonRun Python server

python scripts/auth.py logout

PythonRun Python server

python scripts/drive.py search "quarterly report"

PythonRun Python server

python scripts/drive.py search "title:budget"

+ 7 more commands

📖 Extracted from docs: sanjay3290/ai-skills

Need more details? View full documentation on GitHub →

11Installs

AddedFeb 4, 2026

View on GitHub Back to Skills

Skill Details

SKILL.md

Overview

# 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:

| 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.

More from this repository10

🎯

imagen🎯Skill

Generates AI images on demand using Google Gemini's image generation capabilities for various creative and practical purposes.

🎯

postgres🎯Skill

Generates optimized PostgreSQL database schemas, writes complex queries, and provides performance tuning recommendations for scalable data solutions.

🎯

deep-research🎯Skill

Autonomously conducts comprehensive research tasks using Google Gemini, generating detailed, cited reports across various domains in 2-10 minutes.

🎯

google-calendar🎯Skill

Manages Google Calendar events, enabling scheduling, listing, creating, updating, and finding free time slots for Google Workspace accounts.

🎯

gmail🎯Skill

Enables searching, reading, sending, and managing Gmail emails via command-line with standalone OAuth authentication.

🎯

google-sheets🎯Skill

Retrieves and exports Google Sheets data in multiple formats, enabling easy spreadsheet content access with standalone OAuth authentication.

🎯

outline🎯Skill

Searches, reads, creates, and manages documents across Outline wiki instances with comprehensive document interaction capabilities.

🎯

google-chat🎯Skill

Automates Google Chat interactions, sending messages, managing conversations, and integrating AI-powered responses across team communication channels.

🎯

google-docs🎯Skill

Enables creating, searching, reading, and editing Google Docs with lightweight OAuth authentication for Google Workspace accounts.

🎯

google-slides🎯Skill

Retrieves text, metadata, and finds Google Slides presentations using standalone OAuth authentication for Google Workspace accounts.