aaaaqwq/google-drive

Google Drive

Upload files, create folders, list and search Google Drive via CLI.

When to use

• Upload proposals, invoices, contracts to client folders
• Create new client folder structure
• List or search files in Drive
• Any Google Drive file management task

Dependencies

• Other skills: google-auth (if token expired)
• External: Python 3, google-api-python-client, google-auth

Paths

| What | Path | |------|------| | Script | $GOOGLE_TOOLS_PATH/drive_manager.py | | Token | $GOOGLE_TOOLS_PATH/token.json | | Credentials | $GOOGLE_TOOLS_PATH/credentials.json | | Venv Python | $GOOGLE_TOOLS_PATH/.venv/bin/python3 |

Known Folder IDs

| Folder | ID | |--------|----| | Root (WeLabelData) | <YOUR_DRIVE_ROOT_ID> | | Clients | <YOUR_CLIENTS_FOLDER_ID> | | Templates | <YOUR_TEMPLATES_FOLDER_ID> |

How to execute

List folder contents

cd $GOOGLE_TOOLS_PATH && python3 drive_manager.py list FOLDER_ID

Create a folder

cd $GOOGLE_TOOLS_PATH && python3 drive_manager.py create-folder "Folder Name" --parent FOLDER_ID

Upload a file

cd $GOOGLE_TOOLS_PATH && python3 drive_manager.py upload /path/to/file.pdf --folder FOLDER_ID
cd $GOOGLE_TOOLS_PATH && python3 drive_manager.py upload /path/to/file.pdf --folder FOLDER_ID --name "Custom Name.pdf"

Search by name

cd $GOOGLE_TOOLS_PATH && python3 drive_manager.py search "query"
cd $GOOGLE_TOOLS_PATH && python3 drive_manager.py search "query" --folder FOLDER_ID

Share file/folder

cd $GOOGLE_TOOLS_PATH && ./.venv/bin/python3 drive_manager.py share FILE_ID --email [email protected] --role writer
cd $GOOGLE_TOOLS_PATH && ./.venv/bin/python3 drive_manager.py share FILE_ID --email [email protected] --role reader --notify --message "Please review"

Check permissions

cd $GOOGLE_TOOLS_PATH && ./.venv/bin/python3 drive_manager.py permissions FILE_ID

Create Google Doc

cd $GOOGLE_TOOLS_PATH && ./.venv/bin/python3 drive_manager.py create-doc "Title" --folder FOLDER_ID
cd $GOOGLE_TOOLS_PATH && ./.venv/bin/python3 drive_manager.py create-doc "Title" --folder FOLDER_ID --html /path/to/content.html

File info (modified time, last editor)

cd $GOOGLE_TOOLS_PATH && ./.venv/bin/python3 drive_manager.py info FILE_ID

Parameters

| Parameter | Description | Default | |-----------|-------------|---------| | folder_id | Folder ID for list command | required | | --parent | Parent folder ID for create-folder | root | | --folder | Target folder ID for upload / search / create-doc | none | | --name | Custom filename for upload | original filename | | --email | Email to share with (share command) | required | | --role | Permission role: reader, writer, commenter | writer | | --notify | Send email notification when sharing | false | | --message | Custom notification message | none | | --html | Path to HTML file for doc content (create-doc) | empty doc |

Examples

List all client folders

cd $GOOGLE_TOOLS_PATH && python3 drive_manager.py list <YOUR_CLIENTS_FOLDER_ID>

Create a new client folder

cd $GOOGLE_TOOLS_PATH && python3 drive_manager.py create-folder "Acme Corp" --parent <YOUR_CLIENTS_FOLDER_ID>

Upload invoice to client folder

cd $GOOGLE_TOOLS_PATH && python3 drive_manager.py upload ~/invoices/inv-100.pdf --folder CLIENT_FOLDER_ID --name "Invoice #100.pdf"

Search for proposals

cd $GOOGLE_TOOLS_PATH && python3 drive_manager.py search "proposal" --folder <YOUR_CLIENTS_FOLDER_ID>

Output Format

All commands output JSON array. Each entry has:

• id — Google Drive file ID
• name — file/folder name
• mimeType — MIME type (application/vnd.google-apps.folder for folders)
• webViewLink — direct link to open in browser

Limitations

• Scopes: uses drive.readonly (list/search) + drive.file (create/upload/share). Cannot modify files not created by this app.
• Upload: single file at a time. For bulk uploads, loop in bash.
• Search: name-based only. Use Google Drive web UI for full-text content search.
• Sharing: can only share files created by this app (drive.file scope). Cannot share files created elsewhere.
• Create-doc: uses Drive API upload with HTML conversion (no Docs API needed). Formatting via HTML.

Troubleshooting

| Problem | Solution | |---------|----------| | token.json expired | Run google-auth skill to refresh | | 403 insufficient permissions | Check scopes in google_scopes.py, may need to re-auth | | File not found on upload | Use absolute path or ~ expansion | | Empty list result | Verify folder ID is correct, check trashed status |

Related skills

• google-auth — OAuth token management
• invoice-generator-agent — generates invoices that can be uploaded here