Agent skill

Google Drive

by sanjay3290 in sanjay3290/ai-skills

Interact with Google Drive - search files, find folders, list contents, download files, upload files, create folders, move, copy, rename, and trash files.

Apache-2.0Auto-check passedBackend & APIs

Install Google Drive

skills CLI
$ npx skills add sanjay3290/ai-skills --skill google-drive -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sanjay3290/ai-skills google-drive --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sanjay3290/ai-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/google-drive .claude/skills/google-drive && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
google-drive
GitHub stars
431
Token cost
~999 tokens
SKILL.md length
189 words
Files
6 (incl. scripts)
Skills in repo
24
Repo updated
First seen
Licence
Apache-2.0

At a glance

Interact with Google Drive - search files, find folders, list contents, download files, upload files, create folders, move, copy, rename, and trash files.

  • User asks to: search Google Drive
  • SKILL.md covers First-Time Setup, Read Commands, Write Commands and Search Query Formats, plus 3 more sections
  • Runs Python scripts from its folder; calls python; reaches drive.google.com
  • Find a file/folder

What it does

Google Drive is an agent skill from sanjay3290/ai-skills. 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.

Its SKILL.md is about 1000 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including scripts (for example `README.md`, `scripts/auth.py` and `scripts/drive.py`).

It sits in Backend & APIs, covering OAuth and OpenID Connect. It works with Google Drive. The repository describes itself as: 24 cross-platform agent skills for Claude Code, Cursor, Codex & Gemini CLI — databases, messaging, research, TTS, DevOps, and Google Workspace. The licence is Apache-2.0.

When your agent uses it

  • User asks to: search Google Drive
  • Find a file/folder
  • List Drive contents
  • Organize Drive content

Example prompts

  • “/google-drive”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 281d88d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 3 files in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • drive.google.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Google Drive loads about 999 tokens when it runs. Until then it costs about 107 tokens; SKILL.md has 189 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~107
When it runs · the whole SKILL.md, loaded when a task matches
~999

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from sanjay3290/ai-skills at commit 281d88d, republished under its Apache-2.0 licence (© sanjay3290). 189 words, ~999 tokens.

Download SKILL.mdSave it as .claude/skills/google-drive/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
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
metadata.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:

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.

© sanjay3290, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts) in skills/google-drive of sanjay3290/ai-skills.

  • SKILL.md
  • README.md
  • requirements.txt
  • scripts/auth.py
  • scripts/drive.py
  • scripts/requirements.txt

Open the folder on GitHubat commit 281d88d

Compare with similar skills

Google Drive next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Google Drive compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Drive this skillsanjay3290/ai-skills431—~999Automated safety check: PassApache-2.0
Web SearchPhilip-Cao-9527/code-note-helper273—~650Automated safety check: PassMIT
Google Drive Automationaiskillstore/marketplace4303 repos~1.1kAutomated safety check: PassApache-2.0
Google DriveCraftOS-dev/CraftBot392—~3.8kAutomated safety check: PassMIT
Google Workspacegoogle/adk-recipes10k—~4.6kAutomated safety check: PassApache-2.0
Fortify Developmentcoollabsio/coolify63k4 repos~1.9kAutomated safety check: PassMIT

Similar skills

  • Web Search

    Philip-Cao-9527/code-note-helper

    为 CodeNote Helper 的 code review、bug 定位、修复方案、浏览器 API、OAuth、第三方平台、审核政策和最新外部事实提供联网检索流程;用户明确要求不联网或只总结本地稳定事实时不要使用。

    273 GitHub stars~650 tokensUpdated 2 mo ago
    Backend & APIsAuto-check passed
  • Google Drive Automation

    aiskillstore/marketplace

    Lightweight Google Drive integration with standalone OAuth authentication.

    430 GitHub starsUsed in 3 repos~1.1k tokens
    Backend & APIsAuto-check passed
  • Google Drive

    CraftOS-dev/CraftBot

    Google Drive API integration with managed OAuth. An agent skill from CraftOS-dev/CraftBot.

    392 GitHub stars~3.8k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Google Workspace

    google/adk-recipes

    Official

    Read/write Google Drive, Docs, Sheets, Gmail, Calendar, Chat, Tasks, Slides via the gws CLI.

    10k GitHub stars~4.6k tokensUpdated today
    Documents & OfficeAuto-check passed
  • Fortify Development

    coollabsio/coolify

    ACTIVATE when the user works on authentication in Laravel. An agent skill from coollabsio/coolify.

    63k GitHub starsUsed in 4 repos~1.9k tokens
    Backend & APIsAuto-check passed
  • Antipattern Prevention

    doorkeeper-gem/doorkeeper

    Avoid common Ruby and Rails antipatterns that degrade maintainability and performance.

    5.5k GitHub stars~1.1k tokensUpdated yesterday
    Backend & APIsAuto-check passed

More from sanjay3290/ai-skills

All 24 skills in this repo
  • Deep Research

    sanjay3290/ai-skills

    Execute autonomous multi-step research using Google Gemini Deep Research Agent.

    431 GitHub starsUsed in 10 repos~683 tokens
    Auto-check: notes
  • Imagen

    sanjay3290/ai-skills

    Generate images using Google Gemini's image generation capabilities.

    431 GitHub starsUsed in 7 repos~657 tokens
    Auto-check passed
  • Whatsapp

    sanjay3290/ai-skills

    Send and receive WhatsApp messages via the unofficial linked-device client pywhats (pip install pywhats) — pair with QR, send text/images, group chat, read receipts, presence/typing, and a…

    431 GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Notebooklm

    sanjay3290/ai-skills

    Query and manage Google NotebookLM notebooks with persistent profile auth, source sync, batch/multi queries, and structured exports.

    431 GitHub stars~655 tokensUpdated 28 days ago
    Auto-check passed
  • Elevenlabs

    sanjay3290/ai-skills

    Convert documents and text to audio using ElevenLabs text-to-speech.

    431 GitHub starsUsed in 1 repo~1.1k tokens
    Auto-check passed
  • Postgres

    sanjay3290/ai-skills

    Execute read-only SQL queries against multiple PostgreSQL databases.

    431 GitHub starsUsed in 1 repo~975 tokens
    Auto-check passed

Works with

Categories

Questions about Google Drive

What does Google Drive do?

Interact with Google Drive - search files, find folders, list contents, download files, upload files, create folders, move, copy, rename, and trash files. Google Drive is an agent skill from sanjay3290/ai-skills. Interact with Google Drive - search files, find folders, list contents, download files, upload files, create folders, move, copy, rename, and trash files.

When should I use Google Drive?

Google Drive fits situations like: user asks to: search Google Drive; find a file/folder; list Drive contents; organize Drive content.

How do I install Google Drive in Claude Code?

Run `npx skills add sanjay3290/ai-skills --skill google-drive -a claude-code`. Or copy the skill folder (skills/google-drive in sanjay3290/ai-skills) into .claude/skills/google-drive in your project. Claude Code loads it when a task matches its description.

How do I install Google Drive in Codex?

Run `npx skills add sanjay3290/ai-skills --skill google-drive -a codex`. Or copy the skill folder (skills/google-drive in sanjay3290/ai-skills) into .agents/skills/google-drive in your project. Codex loads it when a task matches its description.

Can I use Google Drive in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sanjay3290/ai-skills --skill google-drive -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/google-drive, .gemini/skills/google-drive, .github/skills/google-drive and .opencode/skills/google-drive in your project.

What does Google Drive need to run?

Going by SKILL.md and its folder, Google Drive needs Python for the scripts in its folder and the command-line tools its instructions call (python). Our summary lists: Python 3.

Does Google Drive access the network?

SKILL.md names 1 domain. In commands or code: drive.google.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Google Drive safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Google Drive use?

Google Drive is published under the Apache-2.0 licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Google Drive use?

About 999 tokens (SKILL.md is roughly 4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Google Drive?

Skills that share tags, products or a category with Google Drive: Web Search (Philip-Cao-9527/code-note-helper, 273 stars), Google Drive Automation (aiskillstore/marketplace, 430 stars), Google Drive (CraftOS-dev/CraftBot, 392 stars) and Google Workspace (google/adk-recipes, 10k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Google Drive?

sanjay3290 (a GitHub user) maintains it in sanjay3290/ai-skills, which has 431 GitHub stars. The repository holds 24 skills in this directory. The repository was last updated on September 10, 2026.

Source: sanjay3290/ai-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.