Skip to main content
The Google Drive extension allows your agent to interact with your Google Drive — listing, searching, uploading, downloading, sharing, and organizing files and folders. It supports both personal Drive and shared drives, making it ideal for file management workflows, automated uploads, and permission management.

​
Setup

If you haven’t set up Google OAuth yet, complete the Google OAuth Setup first.
1

Enable the Google Drive API

In your Google Cloud project, navigate to APIs & Services → Library, search for Google Drive API, and click Enable.
2

Install the Extension

ironclaw registry install google-drive
3

Authorize Access

ironclaw tool auth google-drive
IronClaw will provide a URL for you to authenticate - remember to follow the auth setup to enable your agent to capture the callback. If possible, it will open a browser window. Once approved, the token is stored securely and refreshed automatically.
If you already authenticated one Google service, you still need to authenticate each additional Google extension separately.

​
Available Actions

  • list_files: List files and folders, with optional search query, MIME type filter, and folder scope
  • get_file: Retrieve metadata for a specific file (name, type, size, owners, permissions)
  • download_file: Download the content of a file as text or base64
  • upload_file: Upload a new file with specified content and MIME type
  • update_file: Update the content or name of an existing file
  • create_folder: Create a new folder, optionally inside a parent folder
  • delete_file: Permanently delete a file or folder
  • trash_file: Move a file to the trash (recoverable)
  • share_file: Share a file with a user or group with a specified role (reader/writer/owner)
  • list_permissions: List all permissions on a file
  • remove_permission: Remove a specific permission from a file
  • list_shared_drives: List all shared drives accessible to the account

​
Example Usage

Once configured, you can ask your agent things like:
  • “List all PDF files in my Drive”
  • “Upload this report as a file named ‘Q2-Report.txt’”
  • “Download the file named ‘budget.csv’ from my Drive”
  • “Create a folder called ‘Project Assets’ inside my ‘Work’ folder”
  • “Share the contract with bob@example.com as a viewer”
  • “Who has access to my ‘Roadmap’ document?”
  • “Move the old proposal to trash”

​
Working with Shared Drives

If your Google account has access to shared (team) drives, the agent can target them directly:
Say something like: “List all files in our Engineering shared drive.” The agent will use list_shared_drives to find the right drive by name before searching for files within it.