Skip to content
cccskills
FreePublished on GitHub

gdcli

Google Drive CLI for listing, searching, uploading, downloading, and sharing files and folders. Triggers: Google Drive, upload to Drive, download from Drive, share Drive file, find file on Drive, Drive folder, Drive search, gdcli.

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md3.4 KB
  • agents/canvas.yaml196 B

SKILL.md (original)

Review the instructions the agent will receive before you install.

Google Drive CLI

Command-line interface for Google Drive operations.

Installation

In Canvas Notebook Docker, a container admin installs this once:

npm install -g @mariozechner/gdcli

Check if installed:

gdcli --help

Setup

Google Cloud Console (one-time)

  1. Create a new project (or select existing)
  2. Enable the Google Drive API
  3. Set app name in OAuth branding
  4. Add test users (all Gmail addresses you want to use)
  5. Create OAuth client:
    • Click "Create Client"
    • Application type: "Desktop app"
    • Download the JSON file

Configure gdcli

First check if already configured:

gdcli accounts list

If no accounts, guide the user through setup:

  1. Ask if they have a Google Cloud project with Drive API enabled
  2. If not, walk them through the Google Cloud Console steps above
  3. Have them download the OAuth credentials JSON
  4. Run: gdcli accounts credentials ~/path/to/credentials.json
  5. Run: gdcli accounts add <email> (use --manual for browserless OAuth)

Usage

Run gdcli --help for full command reference.

Common operations:

  • gdcli <email> ls [folderId] - List files/folders
  • gdcli <email> ls --query "<query>" - List with Drive query filter
  • gdcli <email> search "<text>" - Full-text content search
  • gdcli <email> download <fileId> [destPath] - Download a file
  • gdcli <email> upload <localPath> [--folder <folderId>] - Upload a file
  • gdcli <email> mkdir <name> - Create a folder
  • gdcli <email> share <fileId> --anyone - Share publicly

Search

Two different commands:

  • search "<text>" - Searches inside file contents (fullText)
  • ls --query "<query>" - Filters by metadata (name, type, date, etc.)

Use ls --query for filename searches!

Query Syntax (for ls --query)

Format: field operator value. Combine with and/or, group with ().

Operators: =, !=, contains, <, >, <=, >=

Examples:

# By filename
ls --query "name = 'report.pdf'"           # exact match
ls --query "name contains 'IMG'"           # prefix match

# By type
ls --query "mimeType = 'application/pdf'"
ls --query "mimeType contains 'image/'"
ls --query "mimeType = 'application/vnd.google-apps.folder'"  # folders

# By date
ls --query "modifiedTime > '2024-01-01'"

# By owner/sharing
ls --query "'me' in owners"
ls --query "sharedWithMe"

# Exclude trash
ls --query "trashed = false"

# Combined
ls --query "name contains 'report' and mimeType = 'application/pdf'"

Ref: https://developers.google.com/drive/api/guides/ref-search-terms

Data Storage

  • ~/.gdcli/credentials.json - OAuth client credentials
  • ~/.gdcli/accounts.json - Account tokens
  • ~/.gdcli/downloads/ - Default download location

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.

The English summary is being prepared. Showing the original description.

canvascoding/canvas-notebook11Updated Oct 19, 2026

Applies Canvas brand colors, typography, and visual polish to artifacts that benefit from a consistent product look-and-feel. Use it when brand colors, style guidelines, visual formatting, or company design standards apply.

The English summary is being prepared. Showing the original description.

canvascoding/canvas-notebook11Updated Oct 19, 2026

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

The English summary is being prepared. Showing the original description.

canvascoding/canvas-notebook11Updated Oct 19, 2026

Create or improve an organization-managed Canvas plugin that combines complete new or existing skills with optional custom MCP and Composio integrations. Use for reusable multi-skill workflows, plugin composition, plugin editing, and plugin graphics.

The English summary is being prepared. Showing the original description.

canvascoding/canvas-notebook11Updated Oct 19, 2026

Use this Canvas-owned clean-room skill to guide collaborative writing for documentation, proposals, technical specs, decision records, PRDs, RFCs, operating guides, and structured memos. Trigger when the user wants help drafting, organizing, refining, reviewing, or testing a document before sharing it.

The English summary is being prepared. Showing the original description.

canvascoding/canvas-notebook11Updated Oct 19, 2026

docx

Free

Use this Canvas-owned clean-room skill for creating, reading, editing, reviewing, redlining, commenting, or repairing Word `.docx` documents. Trigger for Word documents, DOCX files, memos, reports, letters, templates, tracked changes, comments, table of contents, headers, footers, page numbers, and Google Docs-targeted documents that should be authored as DOCX first.

The English summary is being prepared. Showing the original description.

canvascoding/canvas-notebook11Updated Oct 19, 2026

See all skills by canvascoding

Report a problem with this skill