# List Google Drive files

Canonical URL: https://docs.fuse.init.inc/integrations/google-workspace/actions/drive.files.list

List Drive file metadata the connected principal can access. Never returns file content. Optional q is passed only to Drive and is capped at 1,024 characters.

Action ID: `drive.files.list`
Provider: Google Workspace (`google_workspace`)
Contract version: 1

## Risk and exposure

- Risk: Read
- Idempotency: Safe — Safe to retry without coordination; repeats do not create additional side effects.
- Availability: Default
- Exposure: REST, SDK, MCP
- MCP hints: readOnly=true, destructive=false, idempotent=true, openWorld=true

## Required scopes

- `https://www.googleapis.com/auth/drive.metadata.readonly`

## Input schema fields

- `page_size`
- `page_token`
- `q`
- `spaces`
- `corpora`
- `drive_id`
- `order_by`

## Output schema fields

- `files`
- `files[]`
- `files[].id`
- `files[].name`
- `files[].mime_type`
- `files[].parents`
- `files[].parents[]`
- `files[].drive_id`
- `files[].web_view_url`
- `files[].created_at`
- `files[].updated_at`
- `files[].trashed`
- `files[].revision`
- `files[].size_bytes`
- `files[].client_side_encrypted`
- `next_page_token`

Provider overview: https://docs.fuse.init.inc/integrations/google-workspace
Actions index: https://docs.fuse.init.inc/integrations/google-workspace/actions
Exact canonical JSON contract: https://docs.fuse.init.inc/api/catalog/v1/providers/google_workspace/actions/drive.files.list
Deployment-effective discovery: https://api.fuse.init.inc/v1/tenants/%7Btenant_id%7D/providers/google_workspace/actions