Manually initiate Google OAuth authentication flow.

NOTE: This is a legacy OAuth 2.0 tool and is disabled when OAuth 2.1 is enabled. The authentication system automatically handles credential checks and prompts for authentication when needed. Only use this tool if:

1. You need to re-authenticate with different credentials

2. You want to proactively authenticate before using other tools

3. The automatic authentication flow failed and you need to retry

In most cases, simply try calling the Google Workspace tool you need - it will automatically handle authentication if required.

Searches for files and folders within a user's Google Drive, including shared drives.

Lists the user's most recently modified files in Google Drive (across all drives the user has access to). Excludes trashed items.

Returns metadata for a single Google Drive file by ID.

Retrieves the content of a specific Google Drive file by ID, supporting files in shared drives.

• Native Google Docs, Sheets, Slides → exported as text / CSV. • Office files (.docx, .xlsx, .pptx) → unzipped & parsed with std-lib to extract readable text. • PDFs → text extracted with pypdf when possible; scanned/image-only PDFs fall back to a download hint. • Images → returned as base64 with MIME metadata for multimodal clients. • Any other file → downloaded; tries UTF-8 decode, else notes binary.

Downloads a Google Drive file and returns its raw bytes as a base64-encoded blob.

For Google native files (Docs, Sheets, Slides), exports to a useful format:

• Google Docs -> PDF (default) or DOCX if export_format='docx'

• Google Sheets -> XLSX (default), PDF if export_format='pdf', or CSV if export_format='csv'

• Google Slides -> PDF (default) or PPTX if export_format='pptx'

For other files, downloads the original file format.

Size limit: DOWNLOAD_FILE_CONTENT_MAX_MB env var (default 25 MB). Files larger than the limit return an error pointing to read_file_content for text extraction, or a Drive shareable link as a fallback.

Lists files/folders or shared drive containers, supporting shared drives. If drive_id is specified, lists items within that shared drive. folder_id is then relative to that drive (or use drive_id as folder_id for root). If drive_id is not specified, lists items from user's "My Drive" and accessible shared drives (if include_items_from_all_drives is True). Set resource_type to "shared_drives" to list shared drive containers instead of folder contents.

Creates a new folder in Google Drive, supporting creation within shared drives.

Creates a new file in Google Drive, supporting creation within shared drives. Accepts either direct content or a fileUrl to fetch the content from.

Creates a Google Drive resumable upload session and returns the upload URL.

The caller (e.g. a skill running in claude.ai's sandbox) uses the returned upload_url to PUT raw file bytes directly to Google — bypassing MCP transport limits on large content arguments. Only the short URL travels through MCP; the bytes go straight from the sandbox to Google.

Imports a file (Markdown, DOCX, TXT, HTML, RTF, ODT) into Google Docs format with automatic conversion.

Google Drive automatically converts the source file to native Google Docs format, preserving formatting like headings, lists, bold, italic, etc. For batch operations, prefer file_path for files on disk so callers do not need to load full file contents into their context.

Gets detailed metadata about a Google Drive file including sharing permissions.

Searches for a file by name and checks if it has public link sharing enabled.

Updates metadata and properties of a Google Drive file.

Gets the shareable link for a Google Drive file or folder.

Consolidated tool for managing Google Drive file and folder access permissions.

Supports granting, batch-granting, updating, revoking permissions, and transferring file ownership -- all through a single entry point.

Creates a copy of an existing Google Drive file.

This tool copies the template document to a new location with an optional new name. The copy maintains all formatting and content from the original file.

Sets file-level sharing settings and controls link sharing for a Google Drive file or folder.

This is a high-level tool for the most common permission changes. Use this to toggle "anyone with the link" access or configure file-level sharing behavior. For managing individual user/group permissions, use share_drive_file or update_drive_permission instead.

Apply a batch of update requests to a Google Sheet (spreadsheets.batchUpdate).

Used by the QBR skill to create native charts (addChart) and set cell number formats (repeatCell). Build the requests array with scripts/google_native/sheets_charts.build_batch_requests().

Read a Google Sheet's metadata (spreadsheets.get). Use a fields mask to resolve sheet ids (sheets(properties(sheetId,title))) or verify charts (sheets(charts(chartId,spec/title))).

Apply a batch of update requests to a Google Slides presentation (presentations.batchUpdate).

Used by the QBR skill to delete chart placeholders and embed LINKED Sheets charts (createSheetsChart, linkingMode=LINKED). Build requests with scripts/google_native/slides_links.build_link_requests(). Pass writeControl {"requiredRevisionId": ...} (from presentations_get) to guard against clobbering concurrent human edits.

Retries transient Drive eventual-consistency failures (a just-converted Sheet not yet visible to Slides) with exponential backoff up to ~30s.

Read a Google Slides presentation (presentations.get). Use a fields mask:

• slot resolution: slides(objectId,pageElements(objectId,description,title,size,transform,shape/text,elementGroup))

• embed verification: slides(pageElements(objectId,sheetsChart))

• revision guard: revisionId

Read a Google Doc's content and structure (documents.get).

The returned resource's body.content elements carry startIndex/endIndex for every paragraph and text run — use them to compute the index arguments that docs_batch_update requests need, and to verify an edit landed.

Apply a batch of edit requests to a Google Doc (documents.batchUpdate).

Accepts any Docs API request type (insertText, deleteContentRange, updateTextStyle, insertTable, insertInlineImage, ...). Indexes shift as earlier requests in the batch insert or delete content, so order edits from the END of the document toward the start, or send one request per call. Get current indexes from docs_get first. Pass writeControl with the revision id from docs_get to fail fast if the document changed since — otherwise stale indexes edit the wrong ranges silently.

Find-and-replace text across a Google Doc (documents.batchUpdate with one replaceAllText request per item). Preserves surrounding formatting, so it is the safest way to fill placeholders in a template document.