gws-drive

List, search, inspect, download, and export Google Drive files across saved accounts.

28|Updated Jan 3, 2026
One-click install
npx skills add https://github.com/ma08/botfiles --skill gws-drive-ma08
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-drive
Source: https://github.com/ma08/botfiles/tree/main/claude/skills/gws-drive
Command: npx skills add https://github.com/ma08/botfiles --skill gws-drive-ma08

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the friction of switching between multiple Google accounts to access, search, and manage Drive files, removing the need to manually log in and out of different accounts for read-only operations.

Core Features & Use Cases

  • Multi-account Drive access: Seamlessly list, search, inspect, download, and export files from any saved Google account (work, personal, columbia) using simple alias-based commands.
  • Read-only safe defaults: Restricts operations to non-destructive methods by default to prevent accidental changes to your Drive content.
  • Use case: If you need to pull a tax document from your personal Drive and a research paper from your Columbia Drive in the same workflow, this Skill lets you do that without switching browser sessions.

Quick Start

Use the gws-drive skill to list the 10 most recently modified files from your work Google Drive account.

Frequently Asked Questions about gws-drive

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I access Google Drive files from multiple accounts without logging in and out?

This Skill enables read-only access to Google Drive files across multiple pre-configured accounts using alias-based commands. By routing operations through the gws CLI tool with saved account aliases, you avoid manual browser session switching for listing, searching, and downloading files.

Can I export native Google Workspace documents via the Drive API command line?

Yes, you can export native Google Workspace documents using the gws CLI tool. The Skill supports exporting files from configured account aliases, allowing you to download documents from personal, work, or academic Drives directly through the command line interface.

Does this multi-account Google Drive access method allow editing or modifying files?

No, this method restricts operations to read-only access by default to prevent accidental changes to your Drive content. It supports listing, searching, inspecting metadata, downloading binary files, and exporting documents, but does not permit destructive modifications.

What do I need to set up before searching Google Drive files with account aliases?

You need the gws CLI tool installed with valid Google Drive API scopes and pre-saved account aliases. Configuring these aliases beforehand allows the Skill to execute read-only file searches and operations across your personal, work, or academic accounts without manual logins.

How do I search for and download a file from a specific Google Drive account alias?

You execute a search command specifying your desired account alias via the gws CLI tool. Once the target file is located, you can download the binary file or export the native Google Workspace document directly through the alias-based command flow.

What are the limitations of using read-only Google Drive API access for file management?

Read-only Google Drive API access limits you to listing, searching, inspecting metadata, downloading, and exporting files. It prevents accidental data loss by restricting destructive modifications, meaning you cannot rename, move, or delete files through these alias-based commands.