How do I install the Workspace Google Drive skill?

Run npx skillmds@latest add luokai0/workspace-google-drive in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Workspace Google Drive safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Workspace Google Drive?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Workspace Google Drive free to use?

Yes. Installing skills from SkillMD is free. This skill is licensed under Apache-2.

Who published Workspace Google Drive?

luokai0 (@luokai0) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Workspace Google Drive by luokai0 — Agent Skill

Name: Workspace Google Drive
Rating: 4.666666666666667 (3 reviews)
Author: luokai0

Workspace 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, move files, or organize Drive content. Lightweight integration with standalone OAuth authentication supporting full read/write access.

luokai0 Updated Sep 8, 2026 10 repo stars

File contents

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: workspace-google-drive

Automatically refreshes expired tokens using Google's cloud function.

---name: workspace-google-drivedescription: 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---# Google DriveLightweight 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 SetupAuthenticate with Google (opens browser):```bashpython scripts/auth.py login```Check authentication status:```bashpython scripts/auth.py status```Logout when needed:```bashpython scripts/auth.py logout```## Read CommandsAll 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 onlypython 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 youpython scripts/drive.py search --shared-with-me# Search with paginationpython scripts/drive.py search "report" --limit 5 --page-token "..."# Find a folder by exact namepython scripts/drive.py find-folder "Project Documents"# List files in root Drivepython scripts/drive.py list# List files in a specific folderpython scripts/drive.py list 1ABC123xyz --limit 20# Download a filepython scripts/drive.py download 1ABC123xyz ./downloads/report.pdf```## Write Commands```bash# Upload a file to Drive rootpython scripts/drive.py upload ~/Documents/report.pdf# Upload to a specific folderpython scripts/drive.py upload ~/Documents/report.pdf --folder 1ABC123xyz# Upload with a custom namepython scripts/drive.py upload ~/Documents/report.pdf --name "Q4 Report.pdf"# Create a new folderpython scripts/drive.py create-folder "Project Documents"# Create a folder inside another folderpython scripts/drive.py create-folder "Attachments" --parent 1ABC123xyz# Move a file to a different folderpython scripts/drive.py move FILE_ID DESTINATION_FOLDER_ID# Copy a filepython scripts/drive.py copy FILE_IDpython scripts/drive.py copy FILE_ID --name "Report Copy" --folder 1ABC123xyz# Rename a file or folderpython scripts/drive.py rename FILE_ID "New Name.pdf"# Move a file to trashpython scripts/drive.py trash FILE_ID```## Search Query FormatsThe 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 FormatGoogle 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 ManagementTokens stored securely using the system keyring:- **macOS**: Keychain- **Windows**: Windows Credential Locker- **Linux**: Secret Service API (GNOME Keyring, KDE Wallet, etc.)Service name: workspace-google-driveAutomatically refreshes expired tokens using Google's cloud function.

Frequently asked questions