# Google Drive MCP (npm · @piotr-agier/google-drive-mcp)

Secure access to Google Drive, Docs, Sheets, Slides, and Calendar through MCP.

- Trust score: 86/100 (high trust)
- Change this week: 0
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-22

## Components

- npm · `@piotr-agier/google-drive-mcp`: 86/100 (this document), [markdown](https://verifymcp.io/servers/piotr-agier-google-drive-mcp/piotr-agier-google-drive-mcp.md), [page](https://verifymcp.io/servers/piotr-agier-google-drive-mcp/piotr-agier-google-drive-mcp)

## Channel facts

- Registry: `npm`
- Package: `@piotr-agier/google-drive-mcp`
- Version: `2.12.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-22.

- **Supply Chain Security**: 80/100
  - No malware found by supply-chain analysis.
  - CVE check failed: a known high-severity CVE affects zod 3.25.76, a direct dependency. A fixed version is available.
  - No install/post-install scripts declared.
  - Dependency health was assessed across the 190 of 191 dependencies we could resolve, so this covers what we could see, not the whole tree.
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to piotr-agier/google-drive-mcp).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 37 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 67/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 22769 tokens (~175/item across 130 items; 130 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 100/100
  - No destabilizing schema changes in the last 30 days.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 75/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - 0 of 10 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "deleteItem" implies "delete" and declares no destructiveHint at all, which the MCP spec reads as destructive by default.
  - An AI judge read all 130 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

## Install

### How do I install the Google Drive MCP server?

Google Drive MCP runs locally as an npm package, launched with npx -y @piotr-agier/google-drive-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add piotr-agier-google-drive-mcp -- npx -y @piotr-agier/google-drive-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "piotr-agier-google-drive-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@piotr-agier/google-drive-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "piotr-agier-google-drive-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@piotr-agier/google-drive-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add piotr-agier-google-drive-mcp -- npx -y @piotr-agier/google-drive-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "piotr-agier-google-drive-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@piotr-agier/google-drive-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add piotr-agier-google-drive-mcp --command npx --arg -y --arg @piotr-agier/google-drive-mcp
```

### Hermes

```yaml
mcp_servers:
  piotr-agier-google-drive-mcp:
    command: "npx"
    args: ["-y", "@piotr-agier/google-drive-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "piotr-agier-google-drive-mcp": {
      "Transport": "stdio",
      "Command": "npx",
      "Arguments": [
        "-y",
        "@piotr-agier/google-drive-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add piotr-agier-google-drive-mcp -t stdio -c npx -a -y @piotr-agier/google-drive-mcp
```

### Other

```json
{
  "mcpServers": {
    "piotr-agier-google-drive-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@piotr-agier/google-drive-mcp"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-12 (score 86, 0)

- [security] Stability: 0.97 → pass

### 2026-11-11 (score 86, +1)

No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-09 (score 85, +1)

No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-07 (score 84, −2)

- [functional] Stability: pass → 0.83

### 2026-11-01 (score 86, 0)

- [security] Stability: 0.97 → pass

### 2026-10-31 (score 86, 0)

- [security regression] CVE-2026-118773 affects this package: high
- [security regression] CVE-2026-118764 affects this package: high
- [functional] Stability: pass → 0.97

### 2026-10-24 (score 86)

- [security regression] CVE-2023-54404 affects this package: high
- [security regression] Known CVEs: partial → fail

### 2026-10-23 (score 0)

- [functional regression] Security disclosure: unverified → fail

## MCP tools (130)

### `search` (~240 tokens)

Search for files in Google Drive. Results are sorted most-recently-modified first by default; use orderBy for a different order. Set rawQuery=true to pass a raw Google Drive API query supporting operators like modifiedTime, createdTime, mimeType, name contains, etc.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `orderBy` (string): Sort order for results. Keys without 'desc' sort ascending, so 'modifiedTime' is oldest-first. When paging, repeat the same value on every pageToken call.
- `pageSize` (number): Results per page (default 50, max 100)
- `pageToken` (string): Token for next page of results
- `query` (string, required): Search query. When rawQuery=true, this is passed directly to the Google Drive API as the q parameter.
- `rawQuery` (boolean): If true, pass query directly to Google Drive API without wrapping in fullText contains. Enables date filters, mimeType filters, etc.

### `createTextFile` (~91 tokens)

Create a new text or markdown file

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `content` (string, required): File content
- `name` (string, required): File name (.txt or .md)
- `parentFolderId` (string): Parent folder ID

### `updateTextFile` (~94 tokens)

Update an existing text or markdown file

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `content` (string, required): New file content
- `fileId` (string, required): ID of the file to update
- `name` (string): New name (.txt or .md)

### `readTextFile` (~123 tokens)

Read content of a text file (any text/* MIME type, e.g. text/plain, text/markdown, text/csv). For Google Docs, use readGoogleDoc.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `fileId` (string, required): ID of the file to read
- `maxLength` (number): Maximum number of characters (Unicode code points) to return; content beyond this is truncated

### `createFolder` (~76 tokens)

Create a new folder in Google Drive

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `name` (string, required): Folder name
- `parent` (string): Parent folder ID or path

### `listFolder` (~98 tokens)

List contents of a folder (defaults to root)

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `folderId` (string): Folder ID
- `pageSize` (number): Items to return (default 50, max 100)
- `pageToken` (string): Token for next page

### `listSharedDrives` (~86 tokens)

List available Google Shared Drives

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `pageSize` (number): Drives to return (default 50, max 100)
- `pageToken` (string): Token for next page

### `deleteItem` (~77 tokens)

Move a file or folder to trash (can be restored from Google Drive trash)

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `itemId` (string, required): ID of the item to delete

### `renameItem` (~77 tokens)

Rename a file or folder

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `itemId` (string, required): ID of the item to rename
- `newName` (string, required): New name

### `moveItem` (~79 tokens)

Move a file or folder

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `destinationFolderId` (string): Destination folder ID
- `itemId` (string, required): ID of the item to move

### `copyFile` (~121 tokens)

Creates a copy of a Google Drive file or document

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `fileId` (string, required): ID of the file to copy
- `newName` (string): Name for the copied file. If not provided, will use 'Copy of [original name]'
- `parentFolderId` (string): ID or path of the destination folder (defaults to same folder as original)

### `uploadFile` (~367 tokens)

Upload a file (any type: image, audio, video, PDF, etc.) to Google Drive, either from a local path on the server or from base64-encoded content. When fileId is provided, uploads the content as a new version of that existing file (in-place update) instead of creating a new file.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `contentBase64` (string): Base64-encoded file content. Alternative to localPath for clients without access to the server's filesystem. Provide either localPath or contentBase64.
- `convertToGoogleFormat` (boolean): Convert uploaded file to Google Workspace format (e.g., .docx to Google Doc, .xlsx to Google Sheet, .pptx to Google Slides). Defaults to false. Not allowed with fileId.
- `fileId` (string): ID of an existing Drive file to update in place: the uploaded content becomes a new version of this file (same ID, revision history preserved). Omit to create a new file.
- `localPath` (string): Absolute path to the local file to upload (on the machine running this server). Provide either localPath or contentBase64.
- `mimeType` (string): MIME type (auto-detected from extension if omitted)
- `name` (string): File name in Drive (defaults to local filename; required when creating a new file from contentBase64)
- `parentFolderId` (string): Parent folder ID or path (e.g., '/Work/Projects'). Creates folders if needed. Defaults to root. Not allowed with fileId (use moveItem to move a file).

### `downloadFile` (~226 tokens)

Download a Google Drive file to a local path. For Google Workspace files (Docs, Sheets, Slides, Drawings), exports to the specified format. For regular files, downloads as-is. Streams directly to disk.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `exportMimeType` (string): For Google Workspace files: MIME type to export as (e.g., 'application/pdf', 'text/csv'). Auto-detected from file extension if omitted. Ignored for non-Workspace files.
- `fileId` (string, required): Google Drive file ID
- `localPath` (string, required): Absolute local path to save the file (must start with /). Can be a directory (filename auto-resolved from Drive metadata) or a full file path. Path is normalized before use.
- `overwrite` (boolean): Whether to overwrite if file already exists at localPath. When false (default), returns an error instead of replacing the file.

### `listPermissions` (~66 tokens)

List sharing permissions for a file

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `fileId` (string, required): Google Drive file ID

### `addPermission` (~301 tokens)

Add a sharing permission to a file. If the principal already holds a permission on the file, Drive updates that permission instead of creating a second one, and the requested role is applied even when it is a downgrade (asking for 'reader' for an existing 'writer' leaves them as 'reader'). Provide emailAddress for type 'user'/'group', domain for type 'domain', and neither for 'anyone'.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `allowFileDiscovery` (boolean): Only for type 'domain'/'anyone': false (default) = accessible with the link only; true = discoverable in search. Ignored for 'user'/'group'.
- `domain` (string): Target domain, e.g. 'example.com'. Required when type is 'domain'; ignored otherwise.
- `emailAddress` (string): Target user/group email. Required when type is 'user' or 'group'; ignored for 'domain'/'anyone'.
- `emailMessage` (string): Custom message to include in the notification email. Ignored unless sendNotificationEmail is true.
- `fileId` (string, required): Google Drive file ID
- `role` (string): Permission role
- `sendNotificationEmail` (boolean): Send notification email
- `type` (string): Principal type

### `updatePermission` (~84 tokens)

Update an existing permission role

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `fileId` (string, required): Google Drive file ID
- `permissionId` (string, required): Permission ID
- `role` (string, required): New role

### `removePermission` (~98 tokens)

Remove a permission from a file (by permissionId or emailAddress)

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `emailAddress` (string): User email (alternative to permissionId)
- `fileId` (string, required): Google Drive file ID
- `permissionId` (string): Permission ID

### `shareFile` (~161 tokens)

Convenience wrapper to share a file with a user email. If the user already holds a permission on the file, that permission's role is set to the requested one (even when it is a downgrade) instead of creating a duplicate.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `emailAddress` (string, required): User email
- `emailMessage` (string): Custom message to include in the notification email. Ignored unless sendNotificationEmail is true.
- `fileId` (string, required): Google Drive file ID
- `role` (string): Access role
- `sendNotificationEmail` (boolean): Send notification email

### `convertPdfToGoogleDoc` (~102 tokens)

Convert an existing PDF in Drive into an editable Google Doc

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `fileId` (string, required): PDF file ID in Google Drive
- `newName` (string): Optional name for converted Doc
- `parentFolderId` (string): Optional destination folder ID

### `bulkConvertFolderPdfs` (~117 tokens)

Convert all PDFs in a folder into Google Docs and return per-file results

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `continueOnError` (boolean): Continue conversion when one file fails (default: true)
- `folderId` (string, required): Folder ID containing PDFs
- `maxResults` (number): Maximum PDFs to process (1-200, default: 100)

### `uploadPdfWithSplit` (~133 tokens)

Upload PDF and optionally split into chunked parts (metadata split plan for now)

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `localPath` (string, required): Absolute path to local PDF
- `maxPagesPerChunk` (number): Target max pages per chunk (advisory metadata)
- `namePrefix` (string): Optional output name prefix
- `parentFolderId` (string): Optional destination folder ID
- `split` (boolean): Enable split mode

### `getRevisions` (~98 tokens)

List revisions for a file

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `fileId` (string, required): Google Drive file ID
- `pageSize` (number): Max revisions to return (default 50, max 200)
- `pageToken` (string): Page token for pagination

### `restoreRevision` (~123 tokens)

Restore a file to a selected revision (creates a new head revision). Note: workspace files (Docs, Sheets, Slides) are restored via export/import and may lose some formatting.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `confirm` (boolean): Safety flag. Must be true to execute restore.
- `fileId` (string, required): Google Drive file ID
- `revisionId` (string, required): Revision ID to restore

### `manage_accounts` (~155 tokens)

Manage connected Google accounts. action='list' shows all connected accounts (no secrets). action='add' starts an OAuth flow for a new account identified by account_id (alias). action='remove' deletes local tokens for an account. action='set_default' picks which account is used when tool calls omit the `account` parameter.

Input parameters:

- `account_id` (string|null): Account alias. Required for add/remove/set_default. Must match /^[a-z0-9][a-z0-9_-]{0,31}$/ and not be reserved (e.g. 'default', 'all', '*'). Pass JSON null with set_default to clear the current defa…
- `action` (string, required): Which account-lifecycle operation to perform.

### `authGetStatus` (~17 tokens)

Show authentication/token status and scope diagnostics

### `authListScopes` (~19 tokens)

List configured/requested scopes and currently granted scopes

### `authTestFileAccess` (~34 tokens)

Run auth diagnostics against Drive API/file access

Input parameters:

- `fileId` (string): Optional file ID for targeted access check

### `createShortcut` (~140 tokens)

Create a shortcut (link) to a file or folder in Google Drive. Useful for referencing the same document from multiple locations without duplicating it.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `parentFolderId` (string): ID or path of the folder where the shortcut will be created
- `shortcutName` (string): Custom name for the shortcut (defaults to original file name)
- `targetFileId` (string, required): The file or folder ID (not a path) to create a shortcut to

### `lockFile` (~126 tokens)

Lock a file to prevent editing by setting content restrictions. The file remains readable but cannot be modified until unlocked.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `fileId` (string, required): ID of the file to lock
- `ownerRestricted` (boolean): If true, only the file owner can unlock the file (default: false)
- `reason` (string): Reason for locking the file (shown to users who try to edit)

### `unlockFile` (~76 tokens)

Unlock a previously locked file by removing content restrictions, restoring full edit access.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `fileId` (string, required): ID of the file to unlock

### `createGoogleDoc` (~84 tokens)

Create a new Google Doc

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `content` (string, required): Doc content
- `name` (string, required): Doc name
- `parentFolderId` (string): Parent folder ID

### `createDocFromHTML` (~261 tokens)

Create a Google Doc from HTML content in a single Drive API call. HTML tags are converted to native Google Doc styles: <h1> → Heading 1, <h2> → Heading 2, <p> → Normal Text, <b> → bold, <i> → italic, <ul>/<ol> → lists, <table> → tables. Useful when you want native heading/list/table styling applied in one request instead of a createGoogleDoc call followed by per-paragraph formatGoogleDocParagraph requests.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `html` (string, required): HTML content. Use standard tags: <h1>, <h2>, <h3> for headings, <p> for body text, <b>/<i> for inline styles, <ul>/<ol> for lists, <table> for tables. Inline CSS styles are also supported (e.g., font…
- `name` (string, required): Document name in Google Drive
- `parentFolderId` (string): Parent folder ID or path. Defaults to root.

### `updateGoogleDoc` (~224 tokens)

Update an existing Google Doc (replaces all content). The replacement is one atomic batchUpdate, so a failure leaves the document unchanged rather than wiped. For multi-tab docs, specify tabId to replace a single tab's content; leaves other tabs untouched.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `content` (string, required): New content
- `documentId` (string, required): Doc ID
- `ifRevisionId` (string): Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
- `tabId` (string): Optional. Tab ID to replace (from listDocumentTabs). If set, delete+insert run in a single atomic batchUpdate scoped to that tab.

### `insertText` (~434 tokens)

Insert text at a specific index (surgical edit, doesn't replace whole file). Works on Google Docs and text/* files (e.g. text/plain, text/markdown). Index semantics differ by file type: Google Docs use the Docs API's 1-based structural position (includes structural elements); text files use a 0-based Unicode code point (character) offset into the file content. For multi-tab Google Docs, specify tabId to target a specific tab — tabId is not supported on text files.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): The Google Doc or text file ID
- `ifRevisionId` (string): Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
- `index` (number): Position to insert at. Google Docs: 1-based Docs API structural index. Text files: 0-based Unicode code point (character) offset. Provide exactly one of index or textToFind.
- `matchInstance` (number): Which instance of textToFind (default: 1)
- `position` (string): Insert before or after the matched text (default: after). Only used with textToFind.
- `tabId` (string): Optional. Google Docs only — Tab ID to insert into (from listDocumentTabs). If omitted, inserts into the first/default tab. Not supported on text files.
- `text` (string, required): Text to insert
- `textToFind` (string): Google Docs only: locate the insertion point by text instead of index (exact, case-sensitive match). Combine with position (before/after) and matchInstance. If the match ends at the document's final…

### `deleteRange` (~427 tokens)

Delete content between start and end indices. Works on Google Docs and text/* files (e.g. text/plain, text/markdown). Index semantics differ by file type: Google Docs use the Docs API's 1-based structural position (includes structural elements); text files use 0-based Unicode code point (character) offsets into the file content. For multi-tab Google Docs, specify tabId to target a specific tab — tabId is not supported on text files.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): The Google Doc or text file ID
- `endIndex` (number): End index (exclusive). Google Docs: 1-based Docs API structural index. Text files: 0-based Unicode code point (character) offset.
- `ifRevisionId` (string): Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
- `matchInstance` (number): Which instance of textToFind (default: 1)
- `startIndex` (number): Start index (inclusive). Google Docs: 1-based Docs API structural index. Text files: 0-based Unicode code point (character) offset. Provide startIndex+endIndex or textToFind.
- `tabId` (string): Optional. Google Docs only — Tab ID to delete from (from listDocumentTabs). If omitted, deletes from the first/default tab. Not supported on text files.
- `textToFind` (string): Google Docs only: delete the matched text instead of an index range (exact, case-sensitive match). Combine with matchInstance. A match that ends with the document's final paragraph break is trimmed t…

### `readGoogleDoc` (~152 tokens)

Read content of a Google Doc with format options. Supports multi-tab documents. Text/markdown output leads with the document's revisionId — pass it as ifRevisionId on write tools for an optimistic lock.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): The document ID
- `format` (string): Output format (default: text)
- `maxLength` (number): Maximum characters to return
- `tabId` (string): Read a specific tab by ID (from listDocumentTabs). If omitted, all tabs are returned.

### `readGoogleDocPaginated` (~223 tokens)

Read a portion of a Google Doc with pagination support. Use offset and limit to read large documents in chunks, avoiding output size limits.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): The document ID
- `format` (string): Output format (default: text)
- `limit` (number): Maximum characters to return per page (default: 50000, max: 80000; kept below the host's ~100K output cap to leave room for the JSON envelope and newline escaping)
- `offset` (number): Character offset into the output text, not raw doc characters (with format=markdown the title prefix counts). 0-based, default: 0. Pass the previous response's nextOffset to get the following page.
- `tabId` (string): Read a specific tab by ID (from listDocumentTabs). If omitted, all tabs are returned.

### `listDocumentTabs` (~90 tokens)

List all tabs in a Google Doc with their IDs and hierarchy

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): The document ID
- `includeContent` (boolean): Include content summary (character count) for each tab

### `applyTextStyle` (~402 tokens)

Apply text formatting (bold, italic, color, etc.) to a range or found text. Use EITHER startIndex+endIndex OR textToFind for targeting.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `backgroundColor` (string): Hex background color
- `baselineOffset` (string): Vertical text offset: SUPERSCRIPT or SUBSCRIPT. Use NONE to reset text to the normal baseline.
- `bold` (boolean): Make text bold
- `documentId` (string, required): The document ID
- `endIndex` (number): End index (exclusive) - use with startIndex
- `fontFamily` (string): Font family name
- `fontSize` (number): Font size in points
- `foregroundColor` (string): Hex color (e.g., #FF0000)
- `ifRevisionId` (string): Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
- `italic` (boolean): Make text italic
- `linkUrl` (string): URL for hyperlink
- `matchInstance` (number): Which instance of textToFind (default: 1)
- `startIndex` (number): Start index (1-based) - use with endIndex
- `strikethrough` (boolean): Strikethrough text
- `tabId` (string): Optional. Tab ID to format within (from listDocumentTabs). If omitted, operates on the first/default tab.
- `textToFind` (string): Text to find and format (alternative to indices)
- `underline` (boolean): Underline text

### `applyParagraphStyle` (~785 tokens)

Apply paragraph formatting — alignment, indents, spacing, named styles, borders (top/bottom/left/right/between), shading, and pagination controls. Use EITHER startIndex+endIndex OR textToFind OR indexWithinParagraph for targeting. The update styles EVERY paragraph overlapping the range, so one call over the whole body with removeBorders: ["all"] strips every paragraph border from a document.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `alignment` (string): Text alignment
- `avoidWidowAndOrphan` (boolean): Avoid widow and orphan lines
- `borderBetween` (object): Border between consecutive same-styled paragraphs. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
- `borderBottom` (object): Border below the paragraph (a horizontal rule). Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
- `borderLeft` (object): Border left of the paragraph. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
- `borderRight` (object): Border right of the paragraph. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
- `borderTop` (object): Border above the paragraph. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
- `documentId` (string, required): The document ID
- `endIndex` (number): End index (exclusive) - use with startIndex
- `ifRevisionId` (string): Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
- `indentEnd` (number): Right indent in points
- `indentFirstLine` (number): First-line indent in points
- `indentStart` (number): Left indent in points
- `indexWithinParagraph` (number): Any index within the target paragraph
- `keepLinesTogether` (boolean): Keep all lines of the paragraph on one page
- `keepWithNext` (boolean): Keep with next paragraph
- `matchInstance` (number): Which instance of textToFind (default: 1)
- `namedStyleType` (string): Named paragraph style
- `pageBreakBefore` (boolean): Start the paragraph on a new page
- `removeBorders` (array): Border edges to clear at the paragraph level, so each falls back to the border its named style defines (usually none). Does not touch horizontalRule elements. The update applies to EVERY paragraph ov…
- `removeShading` (boolean): Clear the paragraph background shading
- `shading` (string): Paragraph background color as hex (e.g., #F1F3F4)
- `spaceAbove` (number): Space above in points
- `spaceBelow` (number): Space below in points
- `startIndex` (number): Start index (1-based) - use with endIndex
- `tabId` (string): Optional. Tab ID to format within (from listDocumentTabs). If omitted, operates on the first/default tab.
- `textToFind` (string): Text within the target paragraph

### `formatGoogleDocText` (~405 tokens)

Apply text formatting (bold, italic, font, color, links, superscript/subscript) to a range or found text in a Google Doc. Alias for applyTextStyle.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `backgroundColor` (string): Hex background color
- `baselineOffset` (string): Vertical text offset: SUPERSCRIPT or SUBSCRIPT. Use NONE to reset text to the normal baseline.
- `bold` (boolean): Make text bold
- `documentId` (string, required): The document ID
- `endIndex` (number): End index (exclusive) - use with startIndex
- `fontFamily` (string): Font family name
- `fontSize` (number): Font size in points
- `foregroundColor` (string): Hex color (e.g., #FF0000)
- `ifRevisionId` (string): Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
- `italic` (boolean): Make text italic
- `linkUrl` (string): URL for hyperlink
- `matchInstance` (number): Which instance of textToFind (default: 1)
- `startIndex` (number): Start index (1-based) - use with endIndex
- `strikethrough` (boolean): Strikethrough text
- `tabId` (string): Optional. Tab ID to format within (from listDocumentTabs). If omitted, operates on the first/default tab.
- `textToFind` (string): Text to find and format (alternative to indices)
- `underline` (boolean): Underline text

### `formatGoogleDocParagraph` (~733 tokens)

Apply paragraph formatting (alignment, indentation, spacing, heading style, borders, shading) in a Google Doc. Alias for applyParagraphStyle.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `alignment` (string): Text alignment
- `avoidWidowAndOrphan` (boolean): Avoid widow and orphan lines
- `borderBetween` (object): Border between consecutive same-styled paragraphs. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
- `borderBottom` (object): Border below the paragraph (a horizontal rule). Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
- `borderLeft` (object): Border left of the paragraph. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
- `borderRight` (object): Border right of the paragraph. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
- `borderTop` (object): Border above the paragraph. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
- `documentId` (string, required): The document ID
- `endIndex` (number): End index (exclusive) - use with startIndex
- `ifRevisionId` (string): Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
- `indentEnd` (number): Right indent in points
- `indentFirstLine` (number): First-line indent in points
- `indentStart` (number): Left indent in points
- `indexWithinParagraph` (number): Any index within the target paragraph
- `keepLinesTogether` (boolean): Keep all lines of the paragraph on one page
- `keepWithNext` (boolean): Keep with next paragraph
- `matchInstance` (number): Which instance of textToFind (default: 1)
- `namedStyleType` (string): Named paragraph style
- `pageBreakBefore` (boolean): Start the paragraph on a new page
- `removeBorders` (array): Border edges to clear at the paragraph level, so each falls back to the border its named style defines (usually none). Does not touch horizontalRule elements. The update applies to EVERY paragraph ov…
- `removeShading` (boolean): Clear the paragraph background shading
- `shading` (string): Paragraph background color as hex (e.g., #F1F3F4)
- `spaceAbove` (number): Space above in points
- `spaceBelow` (number): Space below in points
- `startIndex` (number): Start index (1-based) - use with endIndex
- `tabId` (string): Optional. Tab ID to format within (from listDocumentTabs). If omitted, operates on the first/default tab.
- `textToFind` (string): Text within the target paragraph

### `createParagraphBullets` (~299 tokens)

Add or remove bullet points / numbered lists on paragraphs in a Google Doc. Target paragraphs by startIndex+endIndex or textToFind. Use bulletPreset='NONE' to remove bullets.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `bulletPreset` (string): Bullet style preset. Use NONE to remove bullets. Default: BULLET_DISC_CIRCLE_SQUARE
- `documentId` (string, required): The document ID
- `endIndex` (number): End index (exclusive) - use with startIndex
- `ifRevisionId` (string): Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
- `matchInstance` (number): Which instance of textToFind (default: 1)
- `startIndex` (number): Start index (1-based) - use with endIndex
- `tabId` (string): Optional. Tab ID to operate within (from listDocumentTabs). If omitted, operates on the first/default tab.
- `textToFind` (string): Text within the target paragraph(s) to bulletize

### `findAndReplaceInDoc` (~433 tokens)

Find and replace text across a Google Document. Dry-run mode counts matches exactly across body, tables, headers, footers, and footnotes. On zero matches the response explains the likeliest lookalike cause (non-breaking spaces, curly quotes, HTML entities, case). For multi-tab docs, specify tabId to scope replacements to a single tab. When replaceText contains a newline, the write is always locked to the revision its matches were located in — even without an explicit ifRevisionId — since the compiled batch targets indices from that read; a concurrent edit fails the call instead of landing at the wrong offsets.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): The document ID
- `dryRun` (boolean): Only count matches, do not modify the document (default: false). Respects tabId scoping.
- `expectedCount` (number): Optional safety guard: the exact number of occurrences you expect to replace. Counted before writing; on a mismatch the call aborts without modifying the document (catches substring collisions and st…
- `findText` (string, required): Text to find
- `ifRevisionId` (string): Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
- `matchCase` (boolean): Case-sensitive match (default: false)
- `replaceText` (string, required): Replacement text
- `tabId` (string): Optional. Tab ID to scope replacements to (from listDocumentTabs). If omitted, replaces across all tabs.

### `listComments` (~118 tokens)

List all comments in a Google Document

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): The document ID
- `includeDeleted` (boolean): Whether to include deleted comments (default: false)
- `pageSize` (number): Max comments to return (1-100, default: 100)
- `pageToken` (string): Token for next page of results

### `getComment` (~80 tokens)

Get a specific comment with its full thread of replies

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `commentId` (string, required): The comment ID
- `documentId` (string, required): The document ID

### `addComment` (~240 tokens)

Add a comment quoting a text range, targeted by startIndex+endIndex or by textToFind. The comment appears in the document's comment panel and records the quoted passage. Google Docs does not support margin-anchored comments through any public API, so the comment is unanchored by design; this is a platform limit, not a failure.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `commentText` (string, required): The comment content
- `documentId` (string, required): The document ID
- `endIndex` (number): End index (exclusive; or use textToFind)
- `matchInstance` (number): Which occurrence of textToFind to quote (1-based, default 1)
- `startIndex` (number): Start index (1-based; or use textToFind)
- `tabId` (string): Tab ID for multi-tab documents (defaults to the document body)
- `textToFind` (string): Quote this exact text instead of using indices (case-sensitive)

### `replyToComment` (~113 tokens)

Add a reply to an existing comment

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `commentId` (string, required): The comment ID to reply to
- `documentId` (string, required): The document ID
- `replyText` (string, required): The reply content
- `resolve` (boolean): Set to true to resolve the comment thread after replying (default: false)

### `deleteComment` (~78 tokens)

Delete a comment from the document

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `commentId` (string, required): The comment ID to delete
- `documentId` (string, required): The document ID

### `getGoogleDocContent` (~125 tokens)

Get content of a Google Doc with text indices for formatting

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): Document ID
- `includeFormatting` (boolean): Include font, style, color, and baseline info for each text span, plus one ¶ line per paragraph with non-default paragraph styles (named style, alignment, visible borders, shading) over its real inde…

### `getGoogleDocContentPaginated` (~257 tokens)

Get a portion of a Google Doc with text indices for formatting, with pagination support. Use offset and limit to read large documents in chunks.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): Document ID
- `includeFormatting` (boolean): Include font, style, color, and baseline info for each text span, plus one ¶ line per paragraph with non-default paragraph styles (named style, alignment, visible borders, shading) over its real inde…
- `limit` (number): Maximum characters to return per page (default: 50000, max: 80000; kept below the host's ~100K output cap to leave room for the JSON envelope and newline escaping). The page end is snapped back to a…
- `offset` (number): Character offset into the formatted indexed output (not raw doc characters). 0-based, default: 0. Pass the previous response's nextOffset to get the following page.

### `getGoogleDocImage` (~236 tokens)

Fetch the bytes of an inline image embedded in a Google Doc, keyed by its inline object ID. Returns a native image the model can see (or base64). The doc is re-fetched so the underlying image URL is always fresh — pass the objectId, never a raw contentUri (those expire). Inline images only; floating/anchored images are not supported.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): Document ID
- `inlineObjectId` (string, required): The inline object ID shown in readGoogleDoc / getGoogleDocContent image placeholders (the objectId=... value, e.g. "kix.abc123")
- `outputFormat` (string): "image" (default) returns a native MCP image block the model can view; "base64" returns a JSON envelope { inlineObjectId, mimeType, byteLength, dataBase64 } for programmatic use (forwarding, save-to-…

### `insertTable` (~233 tokens)

Insert a new table with the specified dimensions at a given index. For multi-tab docs, specify tabId to target a specific tab.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `columns` (number, required): Number of columns for the new table
- `documentId` (string, required): The document ID
- `ifRevisionId` (string): Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
- `index` (number, required): The index (1-based) where the table should be inserted
- `rows` (number, required): Number of rows for the new table
- `tabId` (string): Optional. Tab ID to insert the table into (from listDocumentTabs). If omitted, inserts into the first/default tab.

### `editTableCell` (~295 tokens)

Edit the content and/or style of a specific table cell. Requires knowing the table start index. For multi-tab docs, specify tabId to target a table in a specific tab.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `alignment` (string): Text alignment
- `bold` (boolean): Make text bold
- `columnIndex` (number, required): Column index (0-based)
- `documentId` (string, required): The document ID
- `fontSize` (number): Font size in points
- `ifRevisionId` (string): Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
- `italic` (boolean): Make text italic
- `rowIndex` (number, required): Row index (0-based)
- `tabId` (string): Optional. Tab ID containing the table (from listDocumentTabs). If omitted, operates on the first/default tab.
- `tableStartIndex` (number, required): The starting index of the TABLE element
- `textContent` (string): New text content for the cell (replaces existing)

### `styleDocTable` (~696 tokens)

Style a Docs table in one atomic call: cell borders/background/padding/content alignment (whole table via tableStartLocation, or a cell range subset), fixed column widths, and minimum row heights. Get the real tableStartIndex from the table span line readGoogleDoc or getGoogleDocContent prints (tableStartIndex=N) — never compute it from text offsets. removeBorders: ["all"] unboxes the table (width-0 borders). The API resolves shared edges by applying border updates right-to-left then bottom-to-top.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `backgroundColor` (string): Cell background color as hex (e.g., #F1F3F4)
- `borderBottom` (object): Cell bottom border. Omitted subfields default to a rendering border: color #000000, width 1pt, SOLID.
- `borderLeft` (object): Cell left border. Omitted subfields default to a rendering border: color #000000, width 1pt, SOLID.
- `borderRight` (object): Cell right border. Omitted subfields default to a rendering border: color #000000, width 1pt, SOLID.
- `borderTop` (object): Cell top border. Omitted subfields default to a rendering border: color #000000, width 1pt, SOLID.
- `columnIndex` (number): Optional cell-subset targeting: first column (0-based); needs rowIndex too
- `columnIndices` (array): Columns (0-based) for columnWidth; omit for all columns
- `columnSpan` (number): Columns in the targeted cell range (default: 1)
- `columnWidth` (number): Fixed column width in points (minimum 5)
- `contentAlignment` (string): Vertical content alignment within cells
- `documentId` (string, required): The document ID
- `ifRevisionId` (string): Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
- `minRowHeight` (number): Minimum row height in points
- `padding` (number): Cell padding on all four edges, in points
- `removeBackground` (boolean): Clear the cell background color
- `removeBorders` (array): Border edges to clear via width-0 borders. ["all"] over the whole table = unbox it in one call
- `rowIndex` (number): Optional cell-subset targeting: first row (0-based); needs columnIndex too
- `rowIndices` (array): Rows (0-based) for minRowHeight; omit for all rows
- `rowSpan` (number): Rows in the targeted cell range (default: 1)
- `tabId` (string): Optional. Tab ID containing the table (from listDocumentTabs). If omitted, operates on the first/default tab.
- `tableStartIndex` (number, required): Start index of the TABLE element, as printed by readGoogleDoc / getGoogleDocContent on the table's span line (tableStartIndex=N)

### `insertImageFromUrl` (~134 tokens)

Insert an inline image into a Google Document from a publicly accessible URL

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): The document ID
- `height` (number): Height of the image in points
- `imageUrl` (string, required): Publicly accessible URL to the image
- `index` (number, required): The index (1-based) where the image should be inserted
- `width` (number): Width of the image in points

### `insertLocalImage` (~198 tokens)

Upload a local image file to Google Drive and insert it into a Google Document

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): The document ID
- `height` (number): Height of the image in points
- `index` (number, required): The index (1-based) where the image should be inserted
- `localImagePath` (string, required): Absolute path to the local image file
- `makePublic` (boolean): Make uploaded image publicly accessible (anyone with the link can view). Set to true if the Docs API cannot access the image through the authenticated user's permissions. Default: false
- `uploadToSameFolder` (boolean): Upload to same folder as document (default: true)
- `width` (number): Width of the image in points

### `listGoogleDocs` (~122 tokens)

Lists Google Documents from your Google Drive with optional filtering.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `maxResults` (integer): Maximum number of documents to return (1-100).
- `orderBy` (string): Sort order for results. Keys without 'desc' sort ascending, so 'modifiedTime' is oldest-first.
- `query` (string): Search query to filter documents by name or content.

### `getDocumentInfo` (~75 tokens)

Gets detailed information about a specific Google Document.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): The ID of the Google Document (from the URL).

### `getGoogleDocStyleSummary` (~213 tokens)

Compact style inventory of a whole document in a few hundred tokens: fonts with their size ladders, named-style counts, text colors, bordered and shaded paragraph locations, a table inventory with real index ranges, and the heading outline. The cheap first read before any formatting work, in place of pulling the full document JSON to answer style questions. Counts cover every tab; locations are prefixed with the tab title on a multi-tab document, since index spaces restart per tab. Reports the document's revisionId, so the same read that gives you the indices gives you the lock to pass as ifRevisionId on the write.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): The document ID
- `tabId` (string): Optional. Summarize only this tab (from listDocumentTabs). If omitted, covers every tab.

### `describeGoogleDocRange` (~324 tokens)

Style probe for one spot: the paragraph styles (named style, alignment, borders, shading, indents, spacing, bullets) and text runs (font, size, bold/italic/underline, colors, links) overlapping a range, with the real document index of every paragraph and run so the result feeds straight into applyParagraphStyle or applyTextStyle. Target it with startIndex (optionally endIndex) or with textToFind, not both. Describes one tab's body; headers, footers, and footnotes are separate index spaces and are not included. Reports the document's revisionId, so the same read that gives you the indices gives you the lock to pass as ifRevisionId on the write.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): The document ID
- `endIndex` (number): End index (exclusive). Defaults to startIndex + 1. Only with startIndex.
- `matchInstance` (number): Which occurrence of textToFind (1-based, default 1)
- `startIndex` (number): Start index (1-based). Use this or textToFind.
- `tabId` (string): Optional. Tab to probe (from listDocumentTabs). If omitted, uses the first/default tab.
- `textToFind` (string): Describe the styling at this exact text (case-sensitive). Use this or startIndex.

### `addDocumentTab` (~76 tokens)

Add a new tab in a Google Doc

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): Document ID
- `title` (string, required): Tab title

### `renameDocumentTab` (~85 tokens)

Rename an existing Google Doc tab

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): Document ID
- `tabId` (string, required): Tab ID
- `title` (string, required): New tab title

### `insertSmartChip` (~233 tokens)

Insert a person smart chip (mention) at a document index. Only person chips are supported by the Docs API; date and file chips are read-only.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `chipType` (string, required): Smart chip type (only 'person' is supported)
- `documentId` (string, required): Document ID
- `ifRevisionId` (string): Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
- `index` (number, required): Insertion index (1-based)
- `personEmail` (string, required): Email address for the person mention
- `tabId` (string): Optional. Tab ID to insert into (from listDocumentTabs). If omitted, inserts into the first/default tab.

### `readSmartChips` (~82 tokens)

Read smart chip-like elements (person mentions, rich links, date chips) from the default tab of a document

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `documentId` (string, required): Document ID

### `createFootnote` (~263 tokens)

Create a footnote in a Google Doc. Footnotes cannot be inserted inside equations, headers, footers, or other footnotes. For multi-tab docs, specify tabId to target a specific tab.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `content` (string): Optional text content for the footnote body
- `documentId` (string, required): Document ID
- `endOfSegment` (boolean): If true, insert footnote at the end of the document body (use instead of index)
- `ifRevisionId` (string): Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
- `index` (number): 1-based character index where the footnote reference should be inserted
- `tabId` (string): Optional. Tab ID to insert the footnote into (from listDocumentTabs). If omitted, inserts into the first/default tab.

### `createGoogleSheet` (~212 tokens)

Create a new Google Sheet. By default uses RAW mode which stores values as-is. Set valueInputOption to 'USER_ENTERED' only when you need formulas to be evaluated.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `data` (array, required): Data as array of arrays
- `name` (string, required): Sheet name
- `parentFolderId` (string): Parent folder ID (defaults to root)
- `valueInputOption` (string): RAW (default): Values stored exactly as provided - formulas stored as text strings. Safe for untrusted data. USER_ENTERED: Values parsed like spreadsheet UI - formulas (=SUM, =IF, etc.) are evaluated…

### `updateGoogleSheet` (~222 tokens)

Update an existing Google Sheet. By default uses RAW mode which stores values as-is. Set valueInputOption to 'USER_ENTERED' only when you need formulas to be evaluated.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `data` (array, required): 2D array of values to write
- `range` (string, required): Range to update (e.g., 'Sheet1!A1:C10')
- `spreadsheetId` (string, required): Sheet ID
- `valueInputOption` (string): RAW (default): Values stored exactly as provided - formulas stored as text strings. Safe for untrusted data. USER_ENTERED: Values parsed like spreadsheet UI - formulas (=SUM, =IF, etc.) are evaluated…

### `batchUpdateGoogleSheetValues` (~260 tokens)

Write many ranges in ONE call via spreadsheets.values.batchUpdate. Ranges may sit on different sheets of the same spreadsheet. Prefer this over repeated updateGoogleSheet calls whenever more than one range changes: N separate writes cost N round trips and N units of the per-minute write quota, while one batch costs one of each.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `spreadsheetId` (string, required): Sheet ID
- `updates` (array, required): Ranges to write, each a {range, values} pair. The API does not document precedence for overlapping ranges, so do not overlap them.
- `valueInputOption` (string): Applies to every range in the batch. RAW (default): values stored exactly as provided - formulas stored as text strings. Safe for untrusted data. USER_ENTERED: values parsed like the spreadsheet UI -…

### `updateGoogleSheetIfUnchanged` (~687 tokens)

Write cell values only if the guarded area has not changed since you read it, and get back what was overwritten so the change can be undone. Call once with dryRun:true to obtain the fingerprint, then again passing it as expectedFingerprint. IMPORTANT: this is optimistic and NOT atomic. The Sheets API has no compare-and-swap - unlike Docs, where ifRevisionId is enforced by the API itself - so the check happens in this server, and a write landing in the gap between the read and the write (well under a second) is not caught. It catches the case that actually happens: the model changed since you last looked. To undo a write, call again with updates set to the returned preImage and expectedFingerprint set to the returned postFingerprint - nothing else, since guardRanges defaults to the ranges in updates and preImage already carries exactly the ranges that were written. Any cell listed in the returned hazards cannot be restored by feeding preImage back: updates carries strings, so re-writing the string re-interprets it as a formula, a number or a boolean and the cell changes type. Its native userEnteredValue is returned so that you can restore that one cell outside this server - through the Sheets API's own updateCells, or by hand - so an undo that touches a hazard cell needs that cell handled separately. The hazard list is deliberately not exhaustive: text kept as text via a leading apostrophe is only flagged when it reads as a formula, a number, or TRUE/FALSE - date-shaped text (e.g. '2024-01-01') is not detected.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `dryRun` (boolean): Write nothing; return the current fingerprint, the guarded contents and what would be written. This is how the first fingerprint is obtained.
- `expectedFingerprint` (string): The fingerprint returned by a previous dryRun call. Required unless dryRun is true.
- `guardRanges` (array): Ranges whose contents must be unchanged. Defaults to the ranges in updates. They need NOT cover the writes - guarding a source block while writing a summary elsewhere is a valid pattern - but then th…
- `maxBytes` (number): Byte budget for the same (default 131072)
- `maxCells` (number): Budget for the guarded contents returned on a dryRun or a refusal (default 2000)
- `spreadsheetId` (string, required): Spreadsheet ID
- `updates` (array, required): Ranges to write, ValueRange-shaped, same as batchUpdateGoogleSheetValues. Each one must name a bounded rectangle - a single cell, or both corners given as in "Sheet1!A2:C50". An open-ended range ("Sh…
- `valueInputOption` (string): USER_ENTERED (default) parses formulas; RAW stores them as text. SECURITY: USER_ENTERED evaluates formulas, so never use it with untrusted input.

### `getGoogleSheetContent` (~249 tokens)

Get content of a Google Sheet with cell information. Each row is returned as 'Row N: ' followed by that row's cells separated by tab characters. Returns displayed values by default; set valueRenderOption to 'FORMULA' to read the underlying formulas (e.g. '=SUM(A1:A10)') instead of their results, or 'UNFORMATTED_VALUE' for raw numbers without display formatting. Under UNFORMATTED_VALUE a date or time cell comes back as a spreadsheet serial number (e.g. 45678), not a date string.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `range` (string, required): Range to get (e.g., 'Sheet1!A1:C10')
- `spreadsheetId` (string, required): Spreadsheet ID
- `valueRenderOption` (string): How values are returned: FORMATTED_VALUE (as displayed, default), UNFORMATTED_VALUE (raw values; dates and times come back as serial numbers, not date strings), FORMULA (the formula behind each cell)

### `getGoogleSheetCells` (~456 tokens)

Read Google Sheets cells as structured data instead of joined text: each cell comes back with its own absolute A1 address, and with the formula the user entered AND the value it evaluates to, in one call. Reads several ranges at once and returns them separately. Use getGoogleSheetContent for a quick human-readable dump of one range. Use this tool whenever the result will be written back, compared to a formula, or spans several ranges.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `fields` (array): CellData fields to return. Default ['userEnteredValue','effectiveValue','formattedValue'] gives the formula (userEnteredValue.formulaValue) together with its computed result (effectiveValue, or effec…
- `includeEmpty` (boolean): Return cells that have none of the requested fields as {a1, empty: true}. Default false - addresses are explicit, so gaps are unambiguous.
- `maxBytes` (number): Byte budget for the serialized cells (default 131072), measured on this tool's output. With the default fields, formula-heavy ranges hit this before maxCells, at roughly 1000 cells.
- `maxCells` (number): Cell budget for the whole response (default 2000). On overflow the read stops at a row boundary and returns truncated:true plus nextRanges.
- `ranges` (array, required): A1 ranges to read, e.g. ["'Entity Assumptions'!B52:E52", "'Mgmt Fees Calc'!C6:EB13"]. Returned separately, in this order, each with its own coordinates.
- `sheetMetadata` (array): Per-sheet extras returned once per sheet under `sheets`. `merges`, `frozen` and `dimensionGroups` cover the whole sheet (merges are reported at full extent even when they leave the range). `hiddenRow…
- `spreadsheetId` (string, required): Spreadsheet ID

### `formatGoogleSheetCells` (~138 tokens)

Format cells in a Google Sheet (background, borders, alignment)

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `backgroundColor` (object): Background color (RGB values 0-1)
- `horizontalAlignment` (string): Horizontal alignment
- `range` (string, required): Range to format (e.g., 'A1:C10')
- `spreadsheetId` (string, required): Spreadsheet ID
- `verticalAlignment` (string): Vertical alignment
- `wrapStrategy` (string): Text wrapping

### `formatGoogleSheetText` (~173 tokens)

Apply text formatting to cells in a Google Sheet

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `bold` (boolean): Make text bold
- `fontFamily` (string): Font family name
- `fontSize` (number): Font size in points
- `foregroundColor` (object): Text color (RGB values 0-1)
- `italic` (boolean): Make text italic
- `range` (string, required): Range to format (e.g., 'A1:C10')
- `spreadsheetId` (string, required): Spreadsheet ID
- `strikethrough` (boolean): Strikethrough text
- `underline` (boolean): Underline text

### `formatGoogleSheetNumbers` (~135 tokens)

Apply number formatting to cells in a Google Sheet

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `pattern` (string, required): Number format pattern (e.g., '#,##0.00', 'yyyy-mm-dd', '$#,##0.00', '0.00%')
- `range` (string, required): Range to format (e.g., 'A1:C10')
- `spreadsheetId` (string, required): Spreadsheet ID
- `type` (string): Format type

### `setGoogleSheetBorders` (~195 tokens)

Set borders for cells in a Google Sheet

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `bottom` (boolean): Apply to bottom border
- `color` (object): Border color (RGB values 0-1)
- `innerHorizontal` (boolean): Apply to inner horizontal borders
- `innerVertical` (boolean): Apply to inner vertical borders
- `left` (boolean): Apply to left border
- `range` (string, required): Range to format (e.g., 'A1:C10')
- `right` (boolean): Apply to right border
- `spreadsheetId` (string, required): Spreadsheet ID
- `style` (string, required): Border style
- `top` (boolean): Apply to top border
- `width` (number): Border width (1-3)

### `mergeGoogleSheetCells` (~95 tokens)

Merge cells in a Google Sheet

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `mergeType` (string, required): Merge type
- `range` (string, required): Range to merge (e.g., 'A1:C3')
- `spreadsheetId` (string, required): Spreadsheet ID

### `addGoogleSheetConditionalFormat` (~111 tokens)

Add conditional formatting to a Google Sheet

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `condition` (object, required): Condition configuration
- `format` (object, required): Format to apply when condition is true
- `range` (string, required): Range to apply formatting (e.g., 'A1:C10')
- `spreadsheetId` (string, required): Spreadsheet ID

### `getSpreadsheetInfo` (~79 tokens)

Gets detailed information about a Google Spreadsheet including all sheets/tabs

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `spreadsheetId` (string, required): The ID of the Google Spreadsheet (from the URL)

### `appendSpreadsheetRows` (~164 tokens)

Appends rows of data to the end of a sheet in a Google Spreadsheet

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `range` (string, required): A1 notation range indicating where to append (e.g., 'A1' or 'Sheet1!A1'). Data will be appended starting from this range.
- `spreadsheetId` (string, required): The ID of the Google Spreadsheet (from the URL)
- `valueInputOption` (string): How input data should be interpreted (RAW or USER_ENTERED)
- `values` (array, required): 2D array of values to append. Each inner array represents a row.

### `addSpreadsheetSheet` (~91 tokens)

Adds a new sheet/tab to an existing Google Spreadsheet

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `sheetTitle` (string, required): Title for the new sheet/tab
- `spreadsheetId` (string, required): The ID of the Google Spreadsheet (from the URL)

### `addSheet` (~82 tokens)

Alias for addSpreadsheetSheet (adds a new sheet/tab)

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `spreadsheetId` (string, required): Spreadsheet ID
- `title` (string, required): Title for the new sheet/tab

### `listSheets` (~66 tokens)

List tabs/sheets in a Google Spreadsheet

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `spreadsheetId` (string, required): Spreadsheet ID

### `renameSheet` (~85 tokens)

Rename a sheet/tab by sheetId

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `newTitle` (string, required): New title
- `sheetId` (number, required): Sheet ID
- `spreadsheetId` (string, required): Spreadsheet ID

### `deleteSheet` (~75 tokens)

Delete a sheet/tab by sheetId

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `sheetId` (number, required): Sheet ID
- `spreadsheetId` (string, required): Spreadsheet ID

### `addDataValidation` (~203 tokens)

Add data validation rules to a sheet range

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `conditionType` (string, required): Validation condition type. ONE_OF_RANGE creates a dropdown sourced from a cell range in the same spreadsheet, so the list can be maintained in one place (or imported from a master sheet via IMPORTRAN…
- `range` (string, required): A1 range
- `showCustomUi` (boolean): Show dropdown/custom UI
- `spreadsheetId` (string, required): Spreadsheet ID
- `strict` (boolean): Reject invalid values
- `values` (array, required): Condition values (e.g. list items, threshold). For ONE_OF_RANGE: exactly one value, the source range in A1 notation (e.g. 'Reference!A2:A50'); a leading '=' is added automatically if omitted.

### `protectRange` (~95 tokens)

Protect a range in a spreadsheet

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `description` (string): Protection description
- `range` (string, required): A1 range
- `spreadsheetId` (string, required): Spreadsheet ID
- `warningOnly` (boolean): Warn instead of enforce

### `addNamedRange` (~83 tokens)

Create a named range

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `name` (string, required): Named range name
- `range` (string, required): A1 range
- `spreadsheetId` (string, required): Spreadsheet ID

### `addDimensionGroup` (~212 tokens)

Group a range of rows or columns in a sheet (creates a collapsible outline group). Indices are 0-based and the interval is half-open [startIndex, endIndex) — to group rows 5 through 12 as shown in the UI, pass startIndex: 4, endIndex: 12. Nest groups by adding a second group inside the range of the first.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `dimension` (string, required): Group rows or columns
- `endIndex` (number, required): 0-based end index (exclusive); must be greater than startIndex
- `sheetId` (number, required): Sheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0.
- `spreadsheetId` (string, required): Spreadsheet ID
- `startIndex` (number, required): 0-based start index (inclusive)

### `deleteDimensionGroup` (~269 tokens)

Remove a row or column group from a sheet. The rows/columns themselves are kept; only the grouping is removed. Indices are 0-based and the interval is half-open [startIndex, endIndex). Use listDimensionGroups to read back an existing group's range and pass it in full: the API decrements the group depth of every dimension in the range rather than matching a whole group, so a range that only partially overlaps a group shrinks that group instead of removing it. With a depth-1 group over columns B:E and a depth-2 group over C:D, deleting D:E leaves depth-1 over B:D and depth-2 over C:C.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `dimension` (string, required): Group rows or columns
- `endIndex` (number, required): 0-based end index (exclusive); must be greater than startIndex
- `sheetId` (number, required): Sheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0.
- `spreadsheetId` (string, required): Spreadsheet ID
- `startIndex` (number, required): 0-based start index (inclusive)

### `updateDimensionGroup` (~217 tokens)

Collapse or expand an existing row or column group. Indices are 0-based and the interval is half-open [startIndex, endIndex). Use listDimensionGroups first to find the group's range and depth.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `collapsed` (boolean, required): true to collapse the group, false to expand it
- `depth` (number): Nesting depth of the group, 1 for an outermost group (default 1)
- `dimension` (string, required): Group rows or columns
- `endIndex` (number, required): 0-based end index (exclusive); must be greater than startIndex
- `sheetId` (number, required): Sheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0.
- `spreadsheetId` (string, required): Spreadsheet ID
- `startIndex` (number, required): 0-based start index (inclusive)

### `listDimensionGroups` (~127 tokens)

List the row and column groups of a spreadsheet, with each group's range, nesting depth and collapsed state. Ranges are reported as 0-based half-open intervals, exactly as addDimensionGroup, deleteDimensionGroup and updateDimensionGroup take them.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `sheetId` (number): Limit to one sheet by ID; omit to list every sheet
- `spreadsheetId` (string, required): Spreadsheet ID

### `listGoogleSheets` (~124 tokens)

Lists Google Spreadsheets from your Google Drive with optional filtering

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `maxResults` (number): Maximum number of spreadsheets to return (1-100)
- `orderBy` (string): Sort order for results. Keys without 'desc' sort ascending, so 'modifiedTime' is oldest-first.
- `query` (string): Search query to filter spreadsheets by name or content

### `setColumnWidth` (~201 tokens)

Set the width (in pixels) of one or more columns in a sheet. Indices are 0-based and the interval is half-open [startColumn, endColumn) — to resize a single column at position 5, pass startColumn: 5, endColumn: 6.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `endColumn` (number, required): 0-based end column index (exclusive); must be greater than startColumn
- `pixelSize` (number, required): Column width in pixels (must be >= 0)
- `sheetId` (number, required): Sheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0.
- `spreadsheetId` (string, required): Spreadsheet ID
- `startColumn` (number, required): 0-based start column index (inclusive)

### `setRowHeight` (~201 tokens)

Set the height (in pixels) of one or more rows in a sheet. Indices are 0-based and the interval is half-open [startRow, endRow) — to resize a single row at position 5, pass startRow: 5, endRow: 6.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `endRow` (number, required): 0-based end row index (exclusive); must be greater than startRow
- `pixelSize` (number, required): Row height in pixels (must be >= 0)
- `sheetId` (number, required): Sheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0.
- `spreadsheetId` (string, required): Spreadsheet ID
- `startRow` (number, required): 0-based start row index (inclusive)

### `autoResizeColumns` (~179 tokens)

Auto-size one or more columns to fit their content. Indices are 0-based and the interval is half-open [startColumn, endColumn) — to auto-fit a single column at position 5, pass startColumn: 5, endColumn: 6.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `endColumn` (number, required): 0-based end column index (exclusive); must be greater than startColumn
- `sheetId` (number, required): Sheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0.
- `spreadsheetId` (string, required): Spreadsheet ID
- `startColumn` (number, required): 0-based start column index (inclusive)

### `autoResizeRows` (~179 tokens)

Auto-size one or more rows to fit their content. Indices are 0-based and the interval is half-open [startRow, endRow) — to auto-fit a single row at position 5, pass startRow: 5, endRow: 6.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `endRow` (number, required): 0-based end row index (exclusive); must be greater than startRow
- `sheetId` (number, required): Sheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0.
- `spreadsheetId` (string, required): Spreadsheet ID
- `startRow` (number, required): 0-based start row index (inclusive)

### `hideSheetDimension` (~195 tokens)

Hide a range of columns or rows in a sheet (sets hiddenByUser=true). Indices are 0-based and the interval is half-open [startIndex, endIndex) — to hide a single column/row at position 5, pass startIndex: 5, endIndex: 6.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `dimension` (string, required): Which dimension to hide
- `endIndex` (number, required): 0-based end index (exclusive); must be greater than startIndex
- `sheetId` (number, required): Sheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0.
- `spreadsheetId` (string, required): Spreadsheet ID
- `startIndex` (number, required): 0-based start index (inclusive)

### `showSheetDimension` (~200 tokens)

Show (unhide) a range of columns or rows in a sheet (sets hiddenByUser=false). Indices are 0-based and the interval is half-open [startIndex, endIndex) — to unhide a single column/row at position 5, pass startIndex: 5, endIndex: 6.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `dimension` (string, required): Which dimension to show
- `endIndex` (number, required): 0-based end index (exclusive); must be greater than startIndex
- `sheetId` (number, required): Sheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0.
- `spreadsheetId` (string, required): Spreadsheet ID
- `startIndex` (number, required): 0-based start index (inclusive)

### `createGoogleSlides` (~91 tokens)

Create a new Google Slides presentation

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `name` (string, required): Presentation name
- `parentFolderId` (string): Parent folder ID (defaults to root)
- `slides` (array, required): Array of slide objects

### `updateGoogleSlides` (~80 tokens)

Update an existing Google Slides presentation

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `presentationId` (string, required): Presentation ID
- `slides` (array, required): Array of slide objects to replace existing slides

### `getGoogleSlidesContent` (~83 tokens)

Get content of Google Slides with element IDs for formatting

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `presentationId` (string, required): Presentation ID
- `slideIndex` (number): Specific slide index (optional)

### `formatGoogleSlidesText` (~193 tokens)

Apply text formatting to elements in Google Slides

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `bold` (boolean): Make text bold
- `endIndex` (number): End index (0-based)
- `fontFamily` (string): Font family name
- `fontSize` (number): Font size in points
- `foregroundColor` (object): Text color (RGB values 0-1)
- `italic` (boolean): Make text italic
- `objectId` (string, required): Object ID of the text element
- `presentationId` (string, required): Presentation ID
- `startIndex` (number): Start index (0-based)
- `strikethrough` (boolean): Strikethrough text
- `underline` (boolean): Underline text

### `formatGoogleSlidesParagraph` (~112 tokens)

Apply paragraph formatting to text in Google Slides

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `alignment` (string): Text alignment
- `bulletStyle` (string): Bullet style
- `lineSpacing` (number): Line spacing multiplier
- `objectId` (string, required): Object ID of the text element
- `presentationId` (string, required): Presentation ID

### `styleGoogleSlidesShape` (~134 tokens)

Style shapes in Google Slides

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `backgroundColor` (object): Background color (RGBA values 0-1)
- `objectId` (string, required): Shape object ID
- `outlineColor` (object): Outline color (RGB values 0-1)
- `outlineDashStyle` (string): Outline dash style
- `outlineWeight` (number): Outline thickness in points
- `presentationId` (string, required): Presentation ID

### `setGoogleSlidesBackground` (~97 tokens)

Set background color for slides

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `backgroundColor` (object, required): Background color (RGBA values 0-1)
- `pageObjectIds` (array, required): Array of slide IDs to update
- `presentationId` (string, required): Presentation ID

### `createGoogleSlidesTextBox` (~172 tokens)

Create a text box in Google Slides

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `bold` (boolean): Make text bold
- `fontSize` (number): Font size in points
- `height` (number, required): Height in EMU
- `italic` (boolean): Make text italic
- `pageObjectId` (string, required): Slide ID
- `presentationId` (string, required): Presentation ID
- `text` (string, required): Text content
- `width` (number, required): Width in EMU
- `x` (number, required): X position in EMU (1/360000 cm)
- `y` (number, required): Y position in EMU

### `createGoogleSlidesShape` (~150 tokens)

Create a shape in Google Slides

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `backgroundColor` (object): Fill color (RGBA values 0-1)
- `height` (number, required): Height in EMU
- `pageObjectId` (string, required): Slide ID
- `presentationId` (string, required): Presentation ID
- `shapeType` (string, required): Shape type
- `width` (number, required): Width in EMU
- `x` (number, required): X position in EMU
- `y` (number, required): Y position in EMU

### `getGoogleSlidesSpeakerNotes` (~84 tokens)

Get speaker notes from a specific slide in Google Slides

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `presentationId` (string, required): Presentation ID
- `slideIndex` (number, required): Slide index (0-based)

### `updateGoogleSlidesSpeakerNotes` (~94 tokens)

Update speaker notes for a specific slide in Google Slides

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `notes` (string, required): Speaker notes content
- `presentationId` (string, required): Presentation ID
- `slideIndex` (number, required): Slide index (0-based)

### `deleteGoogleSlide` (~77 tokens)

Delete a slide from a presentation

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `presentationId` (string, required): Presentation ID
- `slideObjectId` (string, required): Slide object ID

### `duplicateSlide` (~76 tokens)

Duplicate a slide in a presentation

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `presentationId` (string, required): Presentation ID
- `slideObjectId` (string, required): Slide object ID

### `reorderSlides` (~92 tokens)

Reorder one or more slides in a presentation

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `insertionIndex` (number, required): Target insertion index
- `presentationId` (string, required): Presentation ID
- `slideObjectIds` (array, required): Slide object IDs to move

### `replaceAllTextInSlides` (~100 tokens)

Replace all matching text across presentation slides

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `containsText` (string, required): Text to find
- `matchCase` (boolean): Case-sensitive match
- `presentationId` (string, required): Presentation ID
- `replaceText` (string, required): Replacement text

### `exportSlideThumbnail` (~96 tokens)

Export a slide thumbnail URL

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `mimeType` (string): Thumbnail MIME type
- `presentationId` (string, required): Presentation ID
- `size` (string): Thumbnail size
- `slideObjectId` (string, required): Slide object ID

### `insertSlidesImageFromUrl` (~173 tokens)

Insert an image into a Google Slides slide from a publicly accessible URL

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `height` (number): Height in EMU (omit to auto-size)
- `imageUrl` (string, required): Publicly accessible URL of the image
- `pageObjectId` (string, required): Slide/page object ID to insert the image into
- `presentationId` (string, required): Presentation ID
- `width` (number): Width in EMU (omit to auto-size)
- `x` (number): X position in EMU (default: 0)
- `y` (number): Y position in EMU (default: 0)

### `getSlideElementInfo` (~96 tokens)

Get position, size, and transform of all elements on a slide. Returns actual rendered bounds.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `presentationId` (string, required): Presentation ID
- `slideObjectId` (string): Slide object ID (omit to get all slides)

### `moveSlideElement` (~143 tokens)

Move and/or resize an element (image, text box, shape) on a Google Slides slide

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `height` (number): New height in EMU
- `objectId` (string, required): Element object ID to move/resize
- `presentationId` (string, required): Presentation ID
- `width` (number): New width in EMU
- `x` (number): New X position in EMU
- `y` (number): New Y position in EMU

### `deleteSlideElement` (~88 tokens)

Delete an element (image, text box, shape) from a Google Slides slide

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `objectId` (string, required): Element object ID to delete
- `presentationId` (string, required): Presentation ID

### `insertSlidesLocalImage` (~176 tokens)

Upload a local image file to Google Drive and insert it into a Google Slides slide

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `height` (number): Height in EMU (omit to auto-size)
- `localImagePath` (string, required): Absolute path to the local image file
- `pageObjectId` (string, required): Slide/page object ID to insert the image into
- `presentationId` (string, required): Presentation ID
- `width` (number): Width in EMU (omit to auto-size)
- `x` (number): X position in EMU (default: 0)
- `y` (number): Y position in EMU (default: 0)

### `setSlideVisibility` (~115 tokens)

Show or hide (skip) slides in one atomic call. Hidden slides are skipped in present mode and PDF export.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `presentationId` (string, required): Presentation ID
- `skipped` (boolean, required): true = hide (skip) the slides, false = show them
- `slideObjectIds` (array, required): Slide object IDs to change

### `replaceSlideImage` (~197 tokens)

Replace an existing image in place, preserving its layering (z-order), position, size, and crop. Unlike delete+insert, which lands the new image on top of the stack, this keeps the image under any overlaid text.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `imageObjectId` (string, required): Object ID of the image to replace (from getSlideElementInfo)
- `imageUrl` (string): Publicly accessible URL of the replacement image (use this OR localImagePath)
- `localImagePath` (string): Absolute path to a local replacement image (uploaded to Drive briefly, then cleaned up)
- `presentationId` (string, required): Presentation ID
- `replaceMethod` (string): How the new image fits the existing bounds (default: CENTER_INSIDE)

### `setElementZOrder` (~137 tokens)

Change the stacking order of page elements (updatePageElementsZOrder). Inserted images land on top of the stack and can cover overlay text — send them backward or to the back. All elements must be on the same page.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `operation` (string, required): Z-order operation applied to the elements
- `pageElementObjectIds` (array, required): Element object IDs to reorder (same page)
- `presentationId` (string, required): Presentation ID

### `setElementText` (~160 tokens)

Replace the entire text of one shape/text box by objectId (element-scoped delete+insert in one atomic call). Unlike replaceAllTextInSlides, this cannot hit other slides, masters, or layouts, and does not depend on matching existing text. Pass empty text to clear the element.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `objectId` (string, required): Object ID of the shape or text box (from getSlideElementInfo / getGoogleSlidesContent)
- `presentationId` (string, required): Presentation ID
- `text` (string, required): New text content (empty string clears the element)

### `listCalendars` (~74 tokens)

List all accessible Google Calendars for the authenticated user

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `showHidden` (boolean): Include hidden calendars (default: false)

### `getCalendarEvents` (~187 tokens)

Get events from a Google Calendar with optional filtering

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `calendarId` (string): Calendar ID (default: primary)
- `maxResults` (number): Maximum events to return (1-250, default: 50)
- `orderBy` (string): Sort order (default: startTime)
- `query` (string): Free text search in events
- `singleEvents` (boolean): Expand recurring events into instances (default: true)
- `timeMax` (string): End of time range (RFC3339)
- `timeMin` (string): Start of time range (RFC3339, e.g., '2024-01-01T00:00:00Z')

### `getCalendarEvent` (~83 tokens)

Get a single calendar event by ID

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `calendarId` (string): Calendar ID (default: primary)
- `eventId` (string, required): The event ID to retrieve

### `createCalendarEvent` (~223 tokens)

Create a new calendar event. Supports timed events, all-day events, and Google Meet integration.

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `attachments` (array): File attachments (max 25). For Drive files use the file's share URL as fileUrl.
- `attendees` (array): Email addresses of attendees
- `calendarId` (string): Calendar ID (default: primary)
- `conferenceType` (string): Add Google Meet link
- `description` (string): Event description
- `end` (object, required): End time
- `location` (string): Event location
- `recurrence` (array): RRULE strings for recurring events
- `sendUpdates` (string): Send notifications (default: none)
- `start` (object, required): Start time (use dateTime for timed events, date for all-day)
- `summary` (string, required): Event title
- `visibility` (string): Event visibility

### `updateCalendarEvent` (~198 tokens)

Update an existing calendar event

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `attachments` (array): File attachments (max 25). Replaces existing attachments; pass an empty array to remove all, or omit to keep them. For Drive files use the file's share URL as fileUrl.
- `attendees` (array): Updated attendee emails (replaces existing)
- `calendarId` (string): Calendar ID (default: primary)
- `description` (string): New event description
- `end` (object)
- `eventId` (string, required): The event ID to update
- `location` (string): New event location
- `sendUpdates` (string): Send notifications (default: none)
- `start` (object)
- `summary` (string): New event title

### `deleteCalendarEvent` (~95 tokens)

Delete a calendar event

Input parameters:

- `account` (string): Alias of the Google account to target. Optional — defaults to the session/global default account, or the sole authenticated account. Run manage_accounts list to see available aliases.
- `calendarId` (string): Calendar ID (default: primary)
- `eventId` (string, required): The event ID to delete
- `sendUpdates` (string): Send cancellation notifications (default: none)

## Diagnostics

Captured diagnostic sections: Provenance, Vulnerabilities, Dependencies. The full working is on the page: https://verifymcp.io/servers/piotr-agier-google-drive-mcp/piotr-agier-google-drive-mcp#diagnostics

## Score history

- 2026-11-22: 86
- 2026-11-21: 86
- 2026-11-20: 86
- 2026-11-19: 86
- 2026-11-18: 86
- 2026-11-17: 86
- 2026-11-16: 86
- 2026-11-15: 86
- 2026-11-14: 86
- 2026-11-13: 86
- 2026-11-12: 86
- 2026-11-11: 86
- 2026-11-10: 85
- 2026-11-09: 85
- 2026-11-08: 84
- 2026-11-07: 84
- 2026-11-06: 86
- 2026-11-05: 86
- 2026-11-04: 86
- 2026-11-03: 86
- 2026-11-02: 86
- 2026-11-01: 86
- 2026-10-31: 86
- 2026-10-30: 86
- 2026-10-29: 86
- 2026-10-28: 86
- 2026-10-27: 86
- 2026-10-26: 86
- 2026-10-25: 86
- 2026-10-24: 86

## Common questions

### What is the Google Drive MCP server?

Google Drive MCP is listed in the public MCP registry as io.github.piotr-agier/google-drive-mcp. Secure access to Google Drive, Docs, Sheets, Slides, and Calendar through MCP. This page covers its npm package (@piotr-agier/google-drive-mcp).

### Is the Google Drive MCP server safe to use?

Google Drive MCP scores 86 out of 100 on VerifyMCP. We recorded 3 known advisories against it as of 22 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Google Drive MCP server expose?

Google Drive MCP exposes 130 tools: search, createTextFile, updateTextFile, readTextFile, createFolder, and 125 more. Their descriptions and schemas cost roughly 22,769 tokens of context every time the server is loaded.

### Is the Google Drive MCP server still maintained?

Google Drive MCP is still listed as active in the MCP registry. We last reached this channel on 22 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the Google Drive MCP server under?

Google Drive MCP declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

### What did VerifyMCP test on the Google Drive MCP server?

VerifyMCP ran 16 checks on Google Drive MCP, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- npm package: https://www.npmjs.com/package/@piotr-agier/google-drive-mcp
- Socket report: https://socket.dev/npm/package/@piotr-agier/google-drive-mcp
- Repository: https://github.com/piotr-agier/google-drive-mcp
- Changelog RSS feed: https://verifymcp.io/servers/piotr-agier-google-drive-mcp/piotr-agier-google-drive-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/piotr-agier-google-drive-mcp/piotr-agier-google-drive-mcp/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/piotr-agier-google-drive-mcp/piotr-agier-google-drive-mcp.json
- HTML version of this page: https://verifymcp.io/servers/piotr-agier-google-drive-mcp/piotr-agier-google-drive-mcp
