Google Drive MCP
NPM · @PIOTR-AGIER/GOOGLE-DRIVE-MCP
Secure access to Google Drive, Docs, Sheets, Slides, and Calendar through MCP.
Available components
Last scanned (9 hours ago)
Scores higher than 79% of npm servers
Category Documents and Files
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. How we score → Why this is hard to score →
Supply Chain Security80
- No malware found by supply-chain analysis.Pass
- CVE check failed: a known high-severity CVE affects zod 3.25.76, a direct dependency. A fixed version is available. View diagnostics → Fail
- No install/post-install scripts declared.Pass
- Dependency health was assessed across the 190 of 191 dependencies we could resolve, so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to piotr-agier/google-drive-mcp). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 33 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability67
- AI-judged instruction clarity (excellent).Pass
- 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. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 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. See how to fix → Fail
- An AI judge read all 130 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Checks we ran (16)
- Malware scan
- Known CVEs
- Install scripts
- Dependency health
- Source repository
- Provenance
- License
- Maintenance
- Security disclosure
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Does not apply to this package (2)
- Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
- Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 12 Nov 26 0
- Stability: 0.97 → pass security
- 11 Nov 26 +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.
- 9 Nov 26 +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.
- 7 Nov 26 −2
- Stability: pass → 0.83 functional
- 1 Nov 26 0
- Stability: 0.97 → pass security
- 31 Oct 26 0
- CVE-2026-118773 affects this package: high ▼ security
- CVE-2026-118764 affects this package: high ▼ security
- Stability: pass → 0.97 functional
- 24 Oct 26 −5
- CVE-2023-54404 affects this package: high ▼ security
- Known CVEs: partial → fail ▼ security
- 23 Oct 26 0
- Security disclosure: unverified → fail ▼ functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 18 Nov 2026 · Analysed npm/@piotr-agier/google-drive-mcp@2.12.0
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | piotr-agier/google-drive-mcp |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/piotr-agier/google-drive-mcp/.github/workflows/publish.yml@refs/tags/v2.12.0 |
| Rekor log index | 2950875785 |
| Predicate type | SLSA build provenance https://slsa.dev/provenance/v1 |
| Subject digest | sha512:b2e5eeef561e4c087d3627ef681d5323f971d66c656cbbb390a474258f760091ae33ab79b6ddb25a08bf0aba076f921a99f9f0ffe0815140fa46d2491 |
Background: How many MCP packages publish verified provenance →
Vulnerabilities 3 findings
| ID | CVE | Severity | Vector | Fix available |
|---|---|---|---|---|
| GHSA-3g3m-2fjr-6pw4 | CVE-2026-118773 | medium | yes | |
| GHSA-g3hv-75wg-m249 | CVE-2026-118764 | medium | yes | |
| GHSA-mrhx-c7xc-m3w5 | CVE-2023-54404 | high | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:H | yes |
Background: What a vulnerability scan can and cannot prove →
Dependencies 190 packages
| Packages resolved | 190 |
|---|---|
| Deprecated | 2 |
| Stale | 61 |
| Tree resolution | Partial |
The dependency tree was only partially resolved, so these counts may be incomplete.
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
addComment ~240
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | The comment content |
| documentId | string | yes | 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) |
No output schema declared.
No examples provided.
addDataValidation ~203
Add data validation rules to a sheet range
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 | yes | A1 range |
| showCustomUi | boolean | – | Show dropdown/custom UI |
| spreadsheetId | string | yes | Spreadsheet ID |
| strict | boolean | – | Reject invalid values |
| values | array | yes | 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. |
No output schema declared.
No examples provided.
addDimensionGroup ~212
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Group rows or columns |
| endIndex | number | yes | 0-based end index (exclusive); must be greater than startIndex |
| sheetId | number | yes | Sheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0. |
| spreadsheetId | string | yes | Spreadsheet ID |
| startIndex | number | yes | 0-based start index (inclusive) |
No output schema declared.
No examples provided.
addDocumentTab ~76
Add a new tab in a Google Doc
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Document ID |
| title | string | yes | Tab title |
No output schema declared.
No examples provided.
addGoogleSheetConditionalFormat ~111
Add conditional formatting to a Google Sheet
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Condition configuration |
| format | object | yes | Format to apply when condition is true |
| range | string | yes | Range to apply formatting (e.g., 'A1:C10') |
| spreadsheetId | string | yes | Spreadsheet ID |
No output schema declared.
No examples provided.
addNamedRange ~83
Create a named range
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Named range name |
| range | string | yes | A1 range |
| spreadsheetId | string | yes | Spreadsheet ID |
No output schema declared.
No examples provided.
addPermission ~301
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'.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Google Drive file ID |
| role | string | – | Permission role |
| sendNotificationEmail | boolean | – | Send notification email |
| type | string | – | Principal type |
No output schema declared.
No examples provided.
addSheet ~82
Alias for addSpreadsheetSheet (adds a new sheet/tab)
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Spreadsheet ID |
| title | string | yes | Title for the new sheet/tab |
No output schema declared.
No examples provided.
addSpreadsheetSheet ~91
Adds a new sheet/tab to an existing Google Spreadsheet
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Title for the new sheet/tab |
| spreadsheetId | string | yes | The ID of the Google Spreadsheet (from the URL) |
No output schema declared.
No examples provided.
appendSpreadsheetRows ~164
Appends rows of data to the end of a sheet in a Google Spreadsheet
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | A1 notation range indicating where to append (e.g., 'A1' or 'Sheet1!A1'). Data will be appended starting from this range. |
| spreadsheetId | string | yes | The ID of the Google Spreadsheet (from the URL) |
| valueInputOption | string | – | How input data should be interpreted (RAW or USER_ENTERED) |
| values | array | yes | 2D array of values to append. Each inner array represents a row. |
No output schema declared.
No examples provided.
applyParagraphStyle ~785
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 |
No output schema declared.
No examples provided.
applyTextStyle ~402
Apply text formatting (bold, italic, color, etc.) to a range or found text. Use EITHER startIndex+endIndex OR textToFind for targeting.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 |
No output schema declared.
No examples provided.
authGetStatus ~17
Show authentication/token status and scope diagnostics
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
authListScopes ~19
List configured/requested scopes and currently granted scopes
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
authTestFileAccess ~34
Run auth diagnostics against Drive API/file access
| Name | Type | Req | Description |
|---|---|---|---|
| fileId | string | – | Optional file ID for targeted access check |
No output schema declared.
No examples provided.
autoResizeColumns ~179
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 0-based end column index (exclusive); must be greater than startColumn |
| sheetId | number | yes | Sheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0. |
| spreadsheetId | string | yes | Spreadsheet ID |
| startColumn | number | yes | 0-based start column index (inclusive) |
No output schema declared.
No examples provided.
autoResizeRows ~179
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 0-based end row index (exclusive); must be greater than startRow |
| sheetId | number | yes | Sheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0. |
| spreadsheetId | string | yes | Spreadsheet ID |
| startRow | number | yes | 0-based start row index (inclusive) |
No output schema declared.
No examples provided.
batchUpdateGoogleSheetValues ~260
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Sheet ID |
| updates | array | yes | 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 -… |
No output schema declared.
No examples provided.
bulkConvertFolderPdfs ~117
Convert all PDFs in a folder into Google Docs and return per-file results
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Folder ID containing PDFs |
| maxResults | number | – | Maximum PDFs to process (1-200, default: 100) |
No output schema declared.
No examples provided.
convertPdfToGoogleDoc ~102
Convert an existing PDF in Drive into an editable Google Doc
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | PDF file ID in Google Drive |
| newName | string | – | Optional name for converted Doc |
| parentFolderId | string | – | Optional destination folder ID |
No output schema declared.
No examples provided.
copyFile ~121
Creates a copy of a Google Drive file or document
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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) |
No output schema declared.
No examples provided.
createCalendarEvent ~223
Create a new calendar event. Supports timed events, all-day events, and Google Meet integration.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | End time |
| location | string | – | Event location |
| recurrence | array | – | RRULE strings for recurring events |
| sendUpdates | string | – | Send notifications (default: none) |
| start | object | yes | Start time (use dateTime for timed events, date for all-day) |
| summary | string | yes | Event title |
| visibility | string | – | Event visibility |
No output schema declared.
No examples provided.
createDocFromHTML ~261
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 | yes | Document name in Google Drive |
| parentFolderId | string | – | Parent folder ID or path. Defaults to root. |
No output schema declared.
No examples provided.
createFolder ~76
Create a new folder in Google Drive
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Folder name |
| parent | string | – | Parent folder ID or path |
No output schema declared.
No examples provided.
createFootnote ~263
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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. |
No output schema declared.
No examples provided.
createGoogleDoc ~84
Create a new Google Doc
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Doc content |
| name | string | yes | Doc name |
| parentFolderId | string | – | Parent folder ID |
No output schema declared.
No examples provided.
createGoogleSheet ~212
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Data as array of arrays |
| name | string | yes | 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… |
No output schema declared.
No examples provided.
createGoogleSlides ~91
Create a new Google Slides presentation
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Presentation name |
| parentFolderId | string | – | Parent folder ID (defaults to root) |
| slides | array | yes | Array of slide objects |
No output schema declared.
No examples provided.
createGoogleSlidesShape ~150
Create a shape in Google Slides
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Height in EMU |
| pageObjectId | string | yes | Slide ID |
| presentationId | string | yes | Presentation ID |
| shapeType | string | yes | Shape type |
| width | number | yes | Width in EMU |
| x | number | yes | X position in EMU |
| y | number | yes | Y position in EMU |
No output schema declared.
No examples provided.
createGoogleSlidesTextBox ~172
Create a text box in Google Slides
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Height in EMU |
| italic | boolean | – | Make text italic |
| pageObjectId | string | yes | Slide ID |
| presentationId | string | yes | Presentation ID |
| text | string | yes | Text content |
| width | number | yes | Width in EMU |
| x | number | yes | X position in EMU (1/360000 cm) |
| y | number | yes | Y position in EMU |
No output schema declared.
No examples provided.
createParagraphBullets ~299
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 |
No output schema declared.
No examples provided.
createShortcut ~140
Create a shortcut (link) to a file or folder in Google Drive. Useful for referencing the same document from multiple locations without duplicating it.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | The file or folder ID (not a path) to create a shortcut to |
No output schema declared.
No examples provided.
createTextFile ~91
Create a new text or markdown file
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | File content |
| name | string | yes | File name (.txt or .md) |
| parentFolderId | string | – | Parent folder ID |
No output schema declared.
No examples provided.
deleteCalendarEvent ~95
Delete a calendar event
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | The event ID to delete |
| sendUpdates | string | – | Send cancellation notifications (default: none) |
No output schema declared.
No examples provided.
deleteComment ~78
Delete a comment from the document
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | The comment ID to delete |
| documentId | string | yes | The document ID |
No output schema declared.
No examples provided.
deleteDimensionGroup ~269
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Group rows or columns |
| endIndex | number | yes | 0-based end index (exclusive); must be greater than startIndex |
| sheetId | number | yes | Sheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0. |
| spreadsheetId | string | yes | Spreadsheet ID |
| startIndex | number | yes | 0-based start index (inclusive) |
No output schema declared.
No examples provided.
deleteGoogleSlide ~77
Delete a slide from a presentation
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Presentation ID |
| slideObjectId | string | yes | Slide object ID |
No output schema declared.
No examples provided.
deleteItem ~77
Move a file or folder to trash (can be restored from Google Drive trash)
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | ID of the item to delete |
No output schema declared.
No examples provided.
deleteRange ~427
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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… |
No output schema declared.
No examples provided.
deleteSheet ~75
Delete a sheet/tab by sheetId
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Sheet ID |
| spreadsheetId | string | yes | Spreadsheet ID |
No output schema declared.
No examples provided.
deleteSlideElement ~88
Delete an element (image, text box, shape) from a Google Slides slide
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Element object ID to delete |
| presentationId | string | yes | Presentation ID |
No output schema declared.
No examples provided.
describeGoogleDocRange ~324
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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. |
No output schema declared.
No examples provided.
downloadFile ~226
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Google Drive file ID |
| localPath | string | yes | 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. |
No output schema declared.
No examples provided.
duplicateSlide ~76
Duplicate a slide in a presentation
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Presentation ID |
| slideObjectId | string | yes | Slide object ID |
No output schema declared.
No examples provided.
editTableCell ~295
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Column index (0-based) |
| documentId | string | yes | 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 | yes | Row index (0-based) |
| tabId | string | – | Optional. Tab ID containing the table (from listDocumentTabs). If omitted, operates on the first/default tab. |
| tableStartIndex | number | yes | The starting index of the TABLE element |
| textContent | string | – | New text content for the cell (replaces existing) |
No output schema declared.
No examples provided.
exportSlideThumbnail ~96
Export a slide thumbnail URL
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | Presentation ID |
| size | string | – | Thumbnail size |
| slideObjectId | string | yes | Slide object ID |
No output schema declared.
No examples provided.
findAndReplaceInDoc ~433
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.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 | yes | 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 | yes | Replacement text |
| tabId | string | – | Optional. Tab ID to scope replacements to (from listDocumentTabs). If omitted, replaces across all tabs. |
No output schema declared.
No examples provided.
formatGoogleDocParagraph ~733
Apply paragraph formatting (alignment, indentation, spacing, heading style, borders, shading) in a Google Doc. Alias for applyParagraphStyle.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 |
No output schema declared.
No examples provided.
formatGoogleDocText ~405
Apply text formatting (bold, italic, font, color, links, superscript/subscript) to a range or found text in a Google Doc. Alias for applyTextStyle.
| Name | Type | Req | Description |
|---|---|---|---|
| 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 | yes | 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 |
No output schema declared.
No examples provided.
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.
npm · @piotr-agier/google-drive-mcp
claude mcp add piotr-agier-google-drive-mcp -- npx -y @piotr-agier/google-drive-mcp
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 18 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 18 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.