Google Drive
Google Drive tools let your AI assistant browse folders, search files, open file details, and create Google Docs or Sheets in Drive accounts your administrator connected to Metraclick.
You describe what you want in plain language. Creating a Doc or Sheet happens only after you confirm.
The tools
| Tool | Purpose |
|---|---|
| Browse | List files and folders inside a Drive folder |
| Search | Find files by name or content |
| Get file | Open metadata and links for one file or folder by id |
| Create Doc | Create a Google Doc (after you confirm) |
| Create Sheet | Create a Google Sheet (after you confirm) |
How they work together
Browse / Search → find folders and files (ids + open links)
Get file → inspect one item in more detail
Create Doc/Sheet → make a new file after you confirm
(preferably into a shared folder_id)
Typical flow — find something
- Browse a known folder, or search by words from the title or content.
- Use the returned file id or open the
web_view_linkin the browser. - Ask for Get file if you need fuller metadata.
Typical flow — create a document
- Browse or search to find the destination folder id (recommended).
- Ask the AI to create a Doc or Sheet with a title (and optional body or rows).
- Explicitly confirm before it is created.
What you need
| Requirement | Browse / Search / Get | Create Doc / Sheet |
|---|---|---|
| Metraclick connection | Yes | Yes |
| Google Drive tools enabled | Yes | Yes |
| Google Drive credentials | Yes | Yes |
Your administrator configures Google access (service account, OAuth, or similar). Folders where new files should appear usually need to be shared with that Google identity as Editor.
Important notes
- Create tools need confirmation — Nothing is created until you clearly approve (
confirm=true). There is no dry-run mode for Drive creates. - Prefer a folder — When creating files with a service account, ask to put them in a shared folder so people can find them (not only the service account’s “My Drive”).
- Links in results — Listings include a browser link (
web_view_link) when Google provides one. - Pagination — Browse and search return pages (default 25 items, up to 100). Ask for the next page if results say more are available.
Tool pages
- Browse —
googledrive_browse - Search —
googledrive_search - Get file —
googledrive_file_get - Create Doc —
googledrive_doc_create - Create Sheet —
googledrive_sheet_create