recipe-organize-drive-folder

googleworkspace/cli

Create and organize Google Drive folder structures, then move files into the right locations.

What is recipe-organize-drive-folder?

This recipe automates the creation of folder hierarchies in Google Drive and moves files into organized locations. Use it when you need to set up project structures or reorganize existing files across multiple folders.

Create parent and sub-folders in Google Drive with custom names
Move existing files between folders while preserving history
Remove files from old parent folders during reorganization
List and verify folder contents and structure
Automate multi-level folder hierarchy setup

How to install recipe-organize-drive-folder

npx skills add null --skill recipe-organize-drive-folder

Prerequisites

Google Workspace CLI (gws) installed and configured
gws-drive skill loaded and authenticated
Access to create folders and move files in the target Google Drive

Claude Code

Cursor

Windsurf

Cline

How to use recipe-organize-drive-folder

1.Create a parent project folder using gws drive files create with folder mimeType
2.Create sub-folders by specifying the parent folder ID in the parents parameter
3.Move existing files into folders using gws drive files update with addParents and removeParents
4.List folder contents with gws drive files list to verify the structure is correct

Use cases

Good for

Set up a new project folder structure with Documents, Assets, and Archive sub-folders
Reorganize scattered files from a shared drive into a quarterly project structure
Move files from a temporary upload folder into their permanent project locations
Create a client folder with department-specific sub-folders and distribute files accordingly
Verify and audit folder organization after bulk file movements

Who it's for

Project managers organizing team deliverables
Administrative staff managing shared drive structures
Teams setting up new project workspaces
Anyone automating Google Drive file organization

recipe-organize-drive-folder FAQ

Do I need to authenticate with Google Workspace first?

Yes, you must have gws configured with valid Google Workspace credentials and the gws-drive skill loaded before running this recipe.

Can I move files between different Google Drive accounts?

No, this recipe works within a single authenticated Google Workspace account. Cross-account transfers require additional setup.

What happens to file permissions when I move files?

File permissions are preserved when moving files between folders in the same Drive. The file retains its sharing settings.

Can I create deeply nested folder structures?

Yes, you can create multiple levels by using the parent folder ID from each creation step in the next sub-folder creation command.

Full instructions (SKILL.md)

Source of truth, from googleworkspace/cli.

name: recipe-organize-drive-folder description: "Create a Google Drive folder structure and move files into the right locations." metadata: version: 0.22.5 openclaw: category: "recipe" domain: "productivity" requires: bins: - gws skills: - gws-drive

Organize Files into Google Drive Folders

PREREQUISITE: Load the following skills to execute this recipe: gws-drive

Create a Google Drive folder structure and move files into the right locations.

Steps

Create a project folder: gws drive files create --json '{"name": "Q2 Project", "mimeType": "application/vnd.google-apps.folder"}'
Create sub-folders: gws drive files create --json '{"name": "Documents", "mimeType": "application/vnd.google-apps.folder", "parents": ["PARENT_FOLDER_ID"]}'
Move existing files into folder: gws drive files update --params '{"fileId": "FILE_ID", "addParents": "FOLDER_ID", "removeParents": "OLD_PARENT_ID"}'
Verify structure: gws drive files list --params '{"q": "FOLDER_ID in parents"}' --format table