Browse Google Drive
Tool ID: googledrive_browse
Summary
Lists the files and folders directly inside a Google Drive folder (not nested subfolders in one call). Each item includes name, type, and a link to open it in the browser when available.
When to use it
- Explore a folder — See what is in “root” or a known project folder.
- Find a destination — Get a folder id before creating a Doc or Sheet there.
- Navigate step by step — Browse into a subfolder by using its id as the next
folder_id.
What you need
| Requirement | Required? |
|---|---|
| Metraclick connection | Yes |
| Tool enabled for your account | Yes |
| Google Drive credentials | Yes |
Parameters
| Parameter | Required? | Description |
|---|---|---|
folder_id |
No | Drive folder id to list. Default: root (My Drive root for the connected account). |
page_size |
No | How many items to return (1–100). Default: 25. |
page_token |
No | Token from a previous response to fetch the next page. |
Trashed items are excluded. Results are ordered with folders first, then by name.
What you get back
| Field | Meaning |
|---|---|
folder_id |
Folder that was listed |
count |
How many items in this page |
files |
Items with id, name, mime_type, is_folder, links (web_view_link, and others when available), owners, dates, size |
next_page_token |
Present when more items exist — pass it back to get the next page |
Example prompts
List what is in our Google Drive root folder.
Browse the Marketing folder — here is the folder id — and show names and whether each item is a folder.
Show the next page of that Drive folder listing.
Find the Shared Projects folder id by browsing, then list its contents.
Tips
- One level at a time — Browse does not recurse into subfolders. Open a child folder with a second browse using its
id. - Creating files — Copy a folder’s
idto use with Create Doc or Create Sheet. - Search instead — Use Search when you know words from the file name or content but not where it lives.