Google Drive

Productivityby OpenAI

Work with your Google Drive documents — including Google Docs, Slides, PDFs, and uploaded files (with limited support for Sheets/Excel) — to create summaries, synthesize research, prepare updates, or pull context into new drafts. Combine information across several files to produce clear, structured content without manually switching between documents.

7ChatGPT Tools

OpenAIDeveloper

ProductivityCategory

Available Tools

Copy Document

copy_document

Full Description

Copy a document and return the URL of the new copy.

Parameters (1 required, 1 optional)

Required

urlstring

Google Drive/Docs/Sheets/Slides file URL containing a valid ID (for example https://drive.google.com/file/d/<FILE_ID>/... or https://docs.google.com/document/d/<FILE_ID>/...). Do not pass local filesystem paths, Windows paths, gdrive:// URIs, or plain names.

Optional

new_titlestring

Optional new title for the copied file. Parameter name is `new_title` (not `title`).

Default: null

Create Folder

create_folder

Full Description

Create a folder in Google Drive, optionally under a parent folder.

parent_folder may be a Drive folder ID (e.g., "1A2B3C..."), a folder URL, or the literal string "root" to target the user's Drive root.

Parameters (1 required, 1 optional)

Required

namestring

Name of the new folder.

Optional

parent_folderstring

Optional parent folder reference. Accepted values: folder ID, folder URL, or literal `root`. Parameter name is `parent_folder` (not `parent_id` or `folder_id`).

Default: null

Delete Document

delete_document

Full Description

Permanently delete a Drive file.

Parameters (1 required)

Required

urlstring

Fetch

fetch

Full Description

Download the content and title of a Google Drive file. If download_raw_file is set to True, the file will be downloaded as a raw file. Otherwise, the file will be displayed as text.

Parameters (1 required, 1 optional)

Required

urlstring

Optional

download_raw_fileboolean

Default: False

Get File Metadata

get_file_metadata

Full Description

Return metadata for a Google Drive file or folder without downloading contents.

This action only accepts id.

Parameters (1 required)

Required

idstring

Google Drive file ID only (for example `1abcDEF...`). Do not pass extra parameters.

Get Profile

get_profile

Full Description

Return the current Google Drive user's profile information.

This action takes no parameters.

List Drives

list_drives

Full Description

List shared drives accessible to the user.

This action takes no parameters.

List Folder

list_folder

Full Description

List the files directly contained in a Google Drive folder.

Accepted parameters are only url and top_k.

Parameters (1 required, 1 optional)

Required

urlstring

Google Drive folder URL (for example https://drive.google.com/drive/folders/<FOLDER_ID>). Do not pass `root`, `my-drive`, raw folder names, or local filesystem paths.

Optional

top_kinteger

Maximum number of items to scan in the folder. Parameter name is `top_k`.

Default: 100

Recent Documents

recent_documents

Full Description

Return the most recently modified documents accessible to the user.

Accepted parameters are only top_k and require_viewed_by_user. Set require_viewed_by_user=True to only return files the current user has viewed.

Parameters (1 required, 1 optional)

Required

top_kinteger

Number of recent files to return. Parameter name is `top_k`.

Optional

require_viewed_by_userboolean

When true, return only files viewed by the authenticated user.

Default: False

Search

search

Full Description

Search Google Drive files by query and return basic details.

Accepted parameters are only query, topn, special_filter_query_str, best_effort_fetch, fetch_ttl, and require_viewed_by_user.

Use clear, specific keywords such as project names, collaborators, or file types. Example: `"design doc pptx".


When using query, each search query is an AND token match. Meaning, every token in the query is required to be present in order to match.

Search will return documents that contain all of the keywords in the query.
Therefore, queries should be short and keyword-focused (avoid long natural language).
If no results are found, try the following strategies:

1) Use different or related keywords. 2) Make the query more generic and simpler.

To improve recall, consider variants of your terms: abbreviations, synonyms, etc.
Previous search results can provide hints about useful variants of internal terms — use those to refine queries.

PLUS a special_filter_query_str that uses Google Drive v3 search (the q parameter) for precise filters.

Supported time fields: modifiedTime, createdTime, viewedByMeTime, sharedWithMeTime (ISO 8601, e.g., '2025-09-03T00:00:00').

People/ownership filters: 'me' in owners, 'user@domain.com' in owners, 'user@domain.com' in writers, 'user@domain.com' in readers, sharedWithMe = true.

Type filters: mimeType = 'application/vnd.google-apps.document' (Docs), ...spreadsheet (Sheets), ...presentation (Slides), and mimeType != 'application/vnd.google-apps.folder' to exclude folders.


or mimeType = 'application/vnd.google-apps.folder' to select folders.

Set require_viewed_by_user=True to restrict results to files the current user has viewed. Do not pass unsupported fields like top_k, max_results, page_size, folder_url, query_type, user_message, recency_days, driveId, or include_shared_drives`.

Parameters (1 required, 5 optional)

Required

querystring

Keyword query for Drive search. Use concise terms like project/file names. When this is empty, the action falls back to recent documents.

Optional

best_effort_fetchboolean

When true, attempt to fetch text content for each result.

Default: False

fetch_ttlnumber

Best-effort fetch timeout in seconds when best_effort_fetch=true.

Default: 15.0

require_viewed_by_userboolean

When true, keep only files viewed by the authenticated user.

Default: False

special_filter_query_strstring

Optional raw Google Drive API `q` filter expression for advanced filtering.

topninteger

Maximum results to return. Parameter name is `topn` (not `top_k`, `max_results`, or `page_size`).

Default: 20

Share Document

share_document

Full Description

Share a document with a user or anyone at the company. Provide either user_email or anyone_at_company. When sharing with anyone at the company, you can specify whether to show the file in search results.

Parameters (2 required, 3 optional)

Required

permission

urlstring

Google Drive file URL to share. Folder URLs are not accepted for this action.

Optional

anyone_at_companyboolean

Share with anyone in the workspace/domain.

Default: False

show_in_searchboolean

When sharing with anyone_at_company, whether the file is discoverable in search.

Default: False

user_emailstring

Specific user email to share with. Provide this or set anyone_at_company=true.

Default: null

Links

Website Privacy Policy