@apilium/google-drive

Google Drive integration skill for Mayros -- files, folders, sharing, search via Drive API v3.

Installation

Copy this skill directory into your Mayros skills folder:

cp -r skills/google-drive ~/.mayros/skills/google-drive

Or install via the Mayros CLI:

mayros skill install @apilium/google-drive

Configuration

This skill requires a GOOGLE_ACCESS_TOKEN environment variable with the https://www.googleapis.com/auth/drive scope.

Obtain a Token

Option 1 -- gcloud CLI:

export GOOGLE_ACCESS_TOKEN=$(gcloud auth print-access-token --scopes=https://www.googleapis.com/auth/drive)

Option 2 -- OAuth2 flow: Create credentials in the Google Cloud Console and complete the OAuth2 authorization code flow.

Usage

Once configured, the agent can:

• List files: Browse files and folders in Drive
• Search files: Find files by name, type, or content
• Get metadata: Retrieve detailed file information
• Download/Export: Download files or export Google Workspace files to other formats
• Upload files: Upload new files to Drive
• Create folders: Organize files into folder structures
• Share files: Manage file permissions and sharing
• Delete files: Move files to trash

Example Prompts

"List my recent files in Google Drive"
"Find all spreadsheets in my Drive"
"Share the project proposal with the team as viewers"
"Create a new folder called Q1 Reports"
"Download the budget document as a PDF"

Semantic Predicates

File Type Annotations

The skill automatically annotates query results with file type:

• document -- Google Docs
• spreadsheet -- Google Sheets
• presentation -- Google Slides
• folder -- Folders
• image -- Image files (PNG, JPEG, etc.)
• other -- All other file types

Recency Annotations

• recent -- Modified within the last 24 hours
• this_week -- Modified within the last 7 days
• this_month -- Modified within the last 30 days
• older -- Modified more than 30 days ago

License

MIT