google-drive

Search, list, download, export, and update Google Drive files via Drive v3 REST.

13|1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/AceDataCloud/Skills --skill google-drive-acedatacloud
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-drive
Source: https://github.com/AceDataCloud/Skills/tree/main/skills/google-drive
Command: npx skills add https://github.com/AceDataCloud/Skills --skill google-drive-acedatacloud

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you organize and retrieve files in Google Drive without manually clicking through Drive, including searching by name, reading Google Docs/Sheets/Slides via export, and performing file updates like rename, move, upload, and trash.

Core Features & Use Cases

  • Search and discover files: Find files and shared content by name fragments or full-text using Drive’s query language.
  • Read content correctly for Google-native docs: Export Google Docs/Sheets/Slides to Markdown/text/CSV (and other formats) to get plain content.
  • Safe organization and lifecycle actions: Rename, move between folders, upload binaries (with multipart), and trash/restore with explicit confirmation for destructive actions.
  • Permission awareness: Detect missing write scope (drive) vs read-only (drive.readonly) and guide the user to re-install with the correct scope.

Quick Start

Use this when the user says something like: "Find the latest spreadsheet in my Drive named Q2 OKR and export it as CSV."

Frequently Asked Questions about google-drive

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

FAQPage Schema
How do I export Google Docs and Sheets to plain text or Markdown?

You can export Google Docs, Sheets, and Slides to Markdown, plain text, or CSV by using the Drive v3 REST API endpoints. This directly converts Google-native MIME types into chat-friendly formats for easy reading.

How do I search for files in Google Drive using the REST API?

Searching Google Drive files via the REST API uses Drive's query language to find files by name fragments or full-text. It retrieves file metadata and lists shared content programmatically using curl and jq.

Do I need an OAuth token to upload and rename files on Google Drive?

Yes, modifying Google Drive files like uploading or renaming requires an OAuth bearer token via GOOGLE_DRIVE_TOKEN. Safe modifications also need explicit confirmation and the correct write scope.

Why does my Google Drive API request fail with a read-only scope error?

A Google Drive API request fails with a read-only scope error when the OAuth token lacks write permissions. You must detect the missing drive scope versus drive.readonly and guide re-authorization with the correct scope.

Can I move and organize Google Drive folders in bulk using curl?

Yes, you can safely organize Google Drive folders by moving and renaming files using curl commands with the Drive v3 REST API. Safe organization requires explicit confirmation for destructive lifecycle actions like trashing.