Claude Skill

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

LLM Mart · 0 points · 2 views 0 listing impressions 0 install-command copies
Download sanjay3290-ai-skills-skills_google-drive-c842558.zip · 11 KB

Install

skills CLI npx skills add https://github.com/sanjay3290/ai-skills/tree/main/skills/google-drive
Claude Code claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install sanjay3290-ai-skills@llmmart
Git 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:

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

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.

No comments yet.

Reviews (0)

No reviews yet.