Skip to main content

Overview

The Google Drive server enables AI assistants to interact with Google Drive, providing file storage, search, and management capabilities including support for shared drives through the Google Drive API.

How to Add Google Drive

1

Add Server

Add the Google Drive server to your Civic environment through the server directory.
2

Authorize

Simply log in with your Google account and approve the OAuth consent request. No admin approval needed.
3

Test Connection

Try “List my Google Drive files” to verify the connection works.
Simple OAuth Consent: Google Drive uses standard Google OAuth consent. Works with personal Google accounts and Google Workspace without special admin approval.

What You Can Do

File Search

Search files and folders with Drive query operators

File Access

Read content from Google Docs, Sheets, Office files, and more

File Organization

List and navigate folders in My Drive and shared drives

File Creation

Create new files with content or from URLs

Available Tools (4)

Security note: This server does not include file deletion tools. create_drive_file can write new files to any accessible folder including shared drives. For automated agents in shared drive environments, consider guardrails to restrict folder destinations. See Guardrails.
Search for files and folders using Google Drive search operators. Supports searching in My Drive, shared drives, and all accessible drives. Returns file details including ID, name, type, size, modified time, and Drive web link.
Retrieve content from files by ID. Automatically handles Google Docs, Sheets, Slides (exported as text/CSV), Office files (.docx, .xlsx, .pptx - parsed to extract text), and plain text files. Works with files in shared drives.
List files and folders in a specific location. Defaults to root folder but can list any folder including shared drive roots. Supports filtering to specific shared drives and configurable page sizes up to 100 items.
Create new files in Google Drive with direct content or by fetching from a URL. Supports custom MIME types and folder placement. Works in My Drive and shared drive folders.

Use Cases

“Find all PDF files modified in the last week” - Use Drive search operators to locate specific files.

Content Reading

“Read the content of the project proposal document” - Extract text from Google Docs, Office files, or plain text.

Shared Drive Access

“List all files in the Marketing shared drive” - Access team drives and shared folders.

Folder Navigation

“Show me what’s in my Documents folder” - Browse folder contents programmatically.

File Creation

“Create a new text file with meeting notes” - Generate files directly in Drive.

URL Import

“Create a file from this web page content” - Fetch content from URLs and save to Drive.

Office File Parsing

“Extract text from the budget spreadsheet” - Read content from .xlsx, .docx, .pptx files.
Search Operators: Supports Google Drive query syntax including name contains 'text', mimeType = 'application/pdf', modifiedTime > '2024-01-01'.File Types: Native Google files (Docs, Sheets, Slides) export as text/CSV. Office files are parsed to extract readable text. Binary files attempt UTF-8 decode.Shared Drives: Use drive_id parameter to specify shared drives. Set include_items_from_all_drives: true to search across all accessible drives.

Guardrails

In addition to the 14 universal guardrails, this server has 29 server-specific guardrails across 4 operations.
GuardrailOperationTimingDescription
Allowed Folders for File Creationcreate_drive_fileRequestRestricts file creation to specific approved folders only
Allowed MIME Typescreate_drive_fileRequestRestricts file creation to safe text formats only
Block Creating Dangerous Format Filescreate_drive_fileRequestPrevents creating files with dangerous MIME types
Block Executable File Creationcreate_drive_fileRequestPrevents creation of executable file types
Block File URL Parametercreate_drive_fileRequestDenies use of fileUrl parameter to prevent external file fetching
Block Path Traversal in File Namescreate_drive_fileRequestPrevents file names containing path traversal sequences
Maximum File Content Sizecreate_drive_fileRequestLimits file content size to 1MB maximum
Block Content Access for Dangerous Formatsget_drive_file_contentResponseBlocks accessing content of files with dangerous formats
Blocked File IDsget_drive_file_contentRequestDenies access to specific file IDs on a blocklist
Mask PII in File Contentget_drive_file_contentResponseMasks SSN, credit card numbers, and email addresses in file content
Maximum File Size for Content Accessget_drive_file_contentResponseBlocks access to files larger than 10MB
Redact Credentials in File Contentget_drive_file_contentResponseRedacts API keys, passwords, and tokens from file content
Allowed Folder IDslist_drive_itemsRequestRestricts listing to specific allowlisted folder IDs only
Block Dangerous Formats in Listlist_drive_itemsResponseRedacts files with dangerous formats from list response
Hide Files from Other Userslist_drive_itemsResponseHides files created by other users in shared folders
Maximum List Page Sizelist_drive_itemsRequestLimits the number of items returned per list operation
Allowed Search Corporasearch_drive_filesRequestRestricts search corpora to ‘user’ or specific approved drives
Allowed Shared Drive IDssearch_drive_filesRequestRestricts operations to specific approved shared drives
Block Dangerous Format Searchessearch_drive_filesRequestPrevents searching for files with dangerous formats
Blocked File Extensions in Searchsearch_drive_filesRequestPrevents searching for files with sensitive extensions
Block System Filessearch_drive_filesRequestPrevents searching for or accessing system and hidden files
Block Trashed Itemssearch_drive_filesRequestPrevents searching for or accessing trashed/deleted items
Block Wildcard Search Patternssearch_drive_filesRequestPrevents searching with wildcard patterns that could match all files
Maximum Search Page Sizesearch_drive_filesRequestLimits the number of items returned per search
Redact Dangerous Formats from Searchsearch_drive_filesResponseRedacts files with dangerous formats from search results
Configure guardrails via the Civic UI or ask the Configurator Agent: “Add guardrails to my Google Drive server.”