google-drive-management

Files (5)

• CHANGELOG.md
• LICENSE
• README.md
• SKILL.md
• authenticate.py · scripts/

SKILL.md (first lines)

# Google Drive Management

Comprehensive Google Drive integration enabling search, file operations, folder management, permissions control, and content synchronization through the Google Drive API v3.

## Quick Start

When asked to work with Google Drive:

1. **Authenticate**: Set up OAuth2 credentials (one-time setup)
2. **Search files**: Find files by name, type, or content
3. **Read content**: Download and read file contents
4. **Create/Update**: Upload new files or modify existing ones
5. **Organize**: Create folders and move files
6. **Share**: Manage permissions and sharing

## Prerequisites

### One-Time Setup

**1. Enable Google Drive API:**
```bash
# Visit Google Cloud Console
# https://console.cloud.google.com/

# Enable Drive API for your project
# APIs & Services > Enable APIs and Services > Google Drive API
```

**2. Create OAuth2 Credentials:**
```bash
# In Google Cloud Console:
# APIs & Services > Credentials > Create Credentials > OAuth client ID
# Application type: Desktop app
# Download credentials as credentials.json
```

**3. Install Dependencies:**
```bash
pip install google-auth google-auth-oauthlib google-auth-httplib2 google-api-python-client --break-system-packages
```

**4. Initial Authentication:**
```bash
python scripts/authenticate.py
# Opens browser for Google sign-in
# Saves token.json for future use
```

See [reference/setup-guide.md](reference/setup-guide.md) for detailed setup instructions.

## Core Operations

### Search for Files

**Basic search:**
```bash
python scripts/search_files.py --query "name contains 'report'"
```

**Search patterns:**
```python
# By name
query = "name contains 'Q4 Report'"

# By type
query = "mimeType = 'application/vnd.google-apps.spreadsheet'"

# By folder
query = "'FOLDER_ID' in parents"

# Modified recently
query = "modifiedTime > '2025-01-01T00:00:00'"

# Combination
query = "name contains 'budget' and mimeType contains 'spreadsheet'"
```

**Common searches:**
```bash
# Find all PDFs
python scripts/search_files.py --type pdf

# Find files modified today
python scripts/search_files.py --modified-today

# Find files in specific folder
python scripts/search_files.py --folder "Project Documents"

# Search file content (for Google Docs/Sheets)
python scripts/search_files.py --content "quarterly review"
```

See [reference/search-patterns.md](reference/search-patterns.md) for comprehensive query syntax.

### Read File Content

**Download files:**
```bash
# Google Docs/Sheets/Slides
python scripts/download_file.py --file-id FILE_ID --format pdf
python scripts/download_file.py --file-id FILE_ID --format docx
python scripts/download_file.py --file-id FILE_ID --format xlsx

# Binary files (PDFs, images, etc.)
python scripts/download_file.py --file-id FILE_ID --output ./local-file.pdf
```

**Read Google Docs as text:**
```bash
# Export as plain text
python scripts/read_doc.py --file-id FILE_ID

# Export as markdown
python scripts/read_doc.py --file-id FILE_ID --format markdown
```

**Read Sheets data:**
```bash
# Get sheet as CSV

From astoreyai/claude-skills, MIT.

More from astoreyai/claude-skills