Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
sanjay3290 avatar

Google Drive

  • 771 installs
  • 364 repo stars
  • Updated July 9, 2026
  • sanjay3290/ai-skills

google-drive is an agent skill that searches, lists, uploads, and downloads Google Drive files via OAuth scripts for developers who need Workspace file automation without deploying a Google Drive MCP server.

About

google-drive is an Apache-2.0 agent skill (version 1.0) in sanjay3290/ai-skills providing lightweight Google Drive integration with standalone OAuth—no MCP server required. It requires a Google Workspace account; personal Gmail accounts are not supported. Operations run through scripts/drive.py for search, find-folder, list, download, upload, create folders, move, copy, rename, and trash, with first-time auth via scripts/auth.py login. Search accepts full-text queries, title filters, Drive URLs, folder IDs, and native mimeType pass-through syntax. Google Docs, Sheets, and Slides cannot be downloaded directly; binary files use long Drive file IDs. Developers reach for google-drive when agents must fetch spec PDFs, upload build artifacts, or organize project folders in Workspace Drives during automation or internal tooling work.

  • google-drive

Google Drive by the numbers

  • 771 all-time installs (skills.sh)
  • +7 installs in the week ending Aug 5, 2026 (Skillselion tracking)
  • Ranked #500 of 4,347 Backend & APIs skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/sanjay3290/ai-skills --skill google-drive

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs771
repo stars364
Last updatedJuly 9, 2026
Repositorysanjay3290/ai-skills

How do agents integrate Google Drive file operations?

Use google-drive for development tasks

Who is it for?

Developers automating Google Workspace Drive search, upload, and folder management inside agent sessions without running a dedicated MCP server.

Skip if: Developers on personal Gmail accounts or anyone needing native Google Docs/Sheets/Slides export beyond binary download limitations.

When should I use this skill?

The user asks to search Google Drive, list or download files, upload documents, create folders, or organize Drive content from an agent.

What you get

Authenticated Drive file listings, search results, uploaded files, and local downloads via scripts/drive.py commands.

  • Drive search results
  • uploaded or downloaded files
  • organized folder listings

By the numbers

  • Apache-2.0 skill version 1.0
  • Supports 5 search query formats including full-text, title, URL, folder ID, and mimeType

Files

SKILL.mdMarkdownGitHub ↗

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:

FormatExampleDescription
Full-text"quarterly report"Searches file contents and names
Title"title:budget"Searches file names only
URLhttps://drive.google.com/...Extracts and uses file/folder ID
Folder ID1ABC123...Lists folder contents (25+ char IDs)
Native querymimeType='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.

Related skills

Forks & variants (1)

Google Drive has 1 known copy in the catalog totaling 35 installs. They canonicalize to this original listing.

How it compares

Pick google-drive for scriptable Workspace Drive CRUD without MCP overhead; use a full Workspace MCP when you need multi-product Google APIs beyond Drive files.

FAQ

Does google-drive require an MCP server?

google-drive does not require an MCP server. It uses standalone OAuth through scripts/auth.py and file operations through scripts/drive.py with full read/write Drive access after login.

Which Google accounts does google-drive support?

google-drive requires a Google Workspace account. Personal Gmail accounts are not supported. Google Docs, Sheets, and Slides cannot be downloaded directly—use export workflows for those file types.

Backend & APIsbackendintegrations

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.