Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Google Drive MCP

NPM · @PIOTR-AGIER/GOOGLE-DRIVE-MCP

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

0 this week 86 Trust /100

Last scanned (9 hours ago)

Scores higher than 79% of npm servers

Category Documents and Files

Trust breakdown (7 categories)

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
What we tested

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 →

Changelog

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
Diagnostics

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 →

MCP tools · 130 exposed · ~22,769 tokens

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 →

Tool Tokens
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.

NameTypeReqDescription
accountstring–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.
commentTextstringyesThe comment content
documentIdstringyesThe document ID
endIndexnumber–End index (exclusive; or use textToFind)
matchInstancenumber–Which occurrence of textToFind to quote (1-based, default 1)
startIndexnumber–Start index (1-based; or use textToFind)
tabIdstring–Tab ID for multi-tab documents (defaults to the document body)
textToFindstring–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

NameTypeReqDescription
accountstring–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.
conditionTypestringyesValidation 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…
rangestringyesA1 range
showCustomUiboolean–Show dropdown/custom UI
spreadsheetIdstringyesSpreadsheet ID
strictboolean–Reject invalid values
valuesarrayyesCondition 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.

NameTypeReqDescription
accountstring–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.
dimensionstringyesGroup rows or columns
endIndexnumberyes0-based end index (exclusive); must be greater than startIndex
sheetIdnumberyesSheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0.
spreadsheetIdstringyesSpreadsheet ID
startIndexnumberyes0-based start index (inclusive)

No output schema declared.

No examples provided.

addDocumentTab ~76

Add a new tab in a Google Doc

NameTypeReqDescription
accountstring–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.
documentIdstringyesDocument ID
titlestringyesTab title

No output schema declared.

No examples provided.

addGoogleSheetConditionalFormat ~111

Add conditional formatting to a Google Sheet

NameTypeReqDescription
accountstring–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.
conditionobjectyesCondition configuration
formatobjectyesFormat to apply when condition is true
rangestringyesRange to apply formatting (e.g., 'A1:C10')
spreadsheetIdstringyesSpreadsheet ID

No output schema declared.

No examples provided.

addNamedRange ~83

Create a named range

NameTypeReqDescription
accountstring–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.
namestringyesNamed range name
rangestringyesA1 range
spreadsheetIdstringyesSpreadsheet 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'.

NameTypeReqDescription
accountstring–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.
allowFileDiscoveryboolean–Only for type 'domain'/'anyone': false (default) = accessible with the link only; true = discoverable in search. Ignored for 'user'/'group'.
domainstring–Target domain, e.g. 'example.com'. Required when type is 'domain'; ignored otherwise.
emailAddressstring–Target user/group email. Required when type is 'user' or 'group'; ignored for 'domain'/'anyone'.
emailMessagestring–Custom message to include in the notification email. Ignored unless sendNotificationEmail is true.
fileIdstringyesGoogle Drive file ID
rolestring–Permission role
sendNotificationEmailboolean–Send notification email
typestring–Principal type

No output schema declared.

No examples provided.

addSheet ~82

Alias for addSpreadsheetSheet (adds a new sheet/tab)

NameTypeReqDescription
accountstring–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.
spreadsheetIdstringyesSpreadsheet ID
titlestringyesTitle for the new sheet/tab

No output schema declared.

No examples provided.

addSpreadsheetSheet ~91

Adds a new sheet/tab to an existing Google Spreadsheet

NameTypeReqDescription
accountstring–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.
sheetTitlestringyesTitle for the new sheet/tab
spreadsheetIdstringyesThe 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

NameTypeReqDescription
accountstring–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.
rangestringyesA1 notation range indicating where to append (e.g., 'A1' or 'Sheet1!A1'). Data will be appended starting from this range.
spreadsheetIdstringyesThe ID of the Google Spreadsheet (from the URL)
valueInputOptionstring–How input data should be interpreted (RAW or USER_ENTERED)
valuesarrayyes2D 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.

NameTypeReqDescription
accountstring–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.
alignmentstring–Text alignment
avoidWidowAndOrphanboolean–Avoid widow and orphan lines
borderBetweenobject–Border between consecutive same-styled paragraphs. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
borderBottomobject–Border below the paragraph (a horizontal rule). Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
borderLeftobject–Border left of the paragraph. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
borderRightobject–Border right of the paragraph. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
borderTopobject–Border above the paragraph. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
documentIdstringyesThe document ID
endIndexnumber–End index (exclusive) - use with startIndex
ifRevisionIdstring–Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
indentEndnumber–Right indent in points
indentFirstLinenumber–First-line indent in points
indentStartnumber–Left indent in points
indexWithinParagraphnumber–Any index within the target paragraph
keepLinesTogetherboolean–Keep all lines of the paragraph on one page
keepWithNextboolean–Keep with next paragraph
matchInstancenumber–Which instance of textToFind (default: 1)
namedStyleTypestring–Named paragraph style
pageBreakBeforeboolean–Start the paragraph on a new page
removeBordersarray–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…
removeShadingboolean–Clear the paragraph background shading
shadingstring–Paragraph background color as hex (e.g., #F1F3F4)
spaceAbovenumber–Space above in points
spaceBelownumber–Space below in points
startIndexnumber–Start index (1-based) - use with endIndex
tabIdstring–Optional. Tab ID to format within (from listDocumentTabs). If omitted, operates on the first/default tab.
textToFindstring–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.

NameTypeReqDescription
accountstring–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.
backgroundColorstring–Hex background color
baselineOffsetstring–Vertical text offset: SUPERSCRIPT or SUBSCRIPT. Use NONE to reset text to the normal baseline.
boldboolean–Make text bold
documentIdstringyesThe document ID
endIndexnumber–End index (exclusive) - use with startIndex
fontFamilystring–Font family name
fontSizenumber–Font size in points
foregroundColorstring–Hex color (e.g., #FF0000)
ifRevisionIdstring–Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
italicboolean–Make text italic
linkUrlstring–URL for hyperlink
matchInstancenumber–Which instance of textToFind (default: 1)
startIndexnumber–Start index (1-based) - use with endIndex
strikethroughboolean–Strikethrough text
tabIdstring–Optional. Tab ID to format within (from listDocumentTabs). If omitted, operates on the first/default tab.
textToFindstring–Text to find and format (alternative to indices)
underlineboolean–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

NameTypeReqDescription
fileIdstring–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.

NameTypeReqDescription
accountstring–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.
endColumnnumberyes0-based end column index (exclusive); must be greater than startColumn
sheetIdnumberyesSheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0.
spreadsheetIdstringyesSpreadsheet ID
startColumnnumberyes0-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.

NameTypeReqDescription
accountstring–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.
endRownumberyes0-based end row index (exclusive); must be greater than startRow
sheetIdnumberyesSheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0.
spreadsheetIdstringyesSpreadsheet ID
startRownumberyes0-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.

NameTypeReqDescription
accountstring–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.
spreadsheetIdstringyesSheet ID
updatesarrayyesRanges to write, each a {range, values} pair. The API does not document precedence for overlapping ranges, so do not overlap them.
valueInputOptionstring–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

NameTypeReqDescription
accountstring–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.
continueOnErrorboolean–Continue conversion when one file fails (default: true)
folderIdstringyesFolder ID containing PDFs
maxResultsnumber–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

NameTypeReqDescription
accountstring–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.
fileIdstringyesPDF file ID in Google Drive
newNamestring–Optional name for converted Doc
parentFolderIdstring–Optional destination folder ID

No output schema declared.

No examples provided.

copyFile ~121

Creates a copy of a Google Drive file or document

NameTypeReqDescription
accountstring–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.
fileIdstringyesID of the file to copy
newNamestring–Name for the copied file. If not provided, will use 'Copy of [original name]'
parentFolderIdstring–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.

NameTypeReqDescription
accountstring–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.
attachmentsarray–File attachments (max 25). For Drive files use the file's share URL as fileUrl.
attendeesarray–Email addresses of attendees
calendarIdstring–Calendar ID (default: primary)
conferenceTypestring–Add Google Meet link
descriptionstring–Event description
endobjectyesEnd time
locationstring–Event location
recurrencearray–RRULE strings for recurring events
sendUpdatesstring–Send notifications (default: none)
startobjectyesStart time (use dateTime for timed events, date for all-day)
summarystringyesEvent title
visibilitystring–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.

NameTypeReqDescription
accountstring–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.
htmlstringyesHTML 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…
namestringyesDocument name in Google Drive
parentFolderIdstring–Parent folder ID or path. Defaults to root.

No output schema declared.

No examples provided.

createFolder ~76

Create a new folder in Google Drive

NameTypeReqDescription
accountstring–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.
namestringyesFolder name
parentstring–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.

NameTypeReqDescription
accountstring–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.
contentstring–Optional text content for the footnote body
documentIdstringyesDocument ID
endOfSegmentboolean–If true, insert footnote at the end of the document body (use instead of index)
ifRevisionIdstring–Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
indexnumber–1-based character index where the footnote reference should be inserted
tabIdstring–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

NameTypeReqDescription
accountstring–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.
contentstringyesDoc content
namestringyesDoc name
parentFolderIdstring–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.

NameTypeReqDescription
accountstring–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.
dataarrayyesData as array of arrays
namestringyesSheet name
parentFolderIdstring–Parent folder ID (defaults to root)
valueInputOptionstring–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

NameTypeReqDescription
accountstring–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.
namestringyesPresentation name
parentFolderIdstring–Parent folder ID (defaults to root)
slidesarrayyesArray of slide objects

No output schema declared.

No examples provided.

createGoogleSlidesShape ~150

Create a shape in Google Slides

NameTypeReqDescription
accountstring–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.
backgroundColorobject–Fill color (RGBA values 0-1)
heightnumberyesHeight in EMU
pageObjectIdstringyesSlide ID
presentationIdstringyesPresentation ID
shapeTypestringyesShape type
widthnumberyesWidth in EMU
xnumberyesX position in EMU
ynumberyesY position in EMU

No output schema declared.

No examples provided.

createGoogleSlidesTextBox ~172

Create a text box in Google Slides

NameTypeReqDescription
accountstring–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.
boldboolean–Make text bold
fontSizenumber–Font size in points
heightnumberyesHeight in EMU
italicboolean–Make text italic
pageObjectIdstringyesSlide ID
presentationIdstringyesPresentation ID
textstringyesText content
widthnumberyesWidth in EMU
xnumberyesX position in EMU (1/360000 cm)
ynumberyesY 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.

NameTypeReqDescription
accountstring–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.
bulletPresetstring–Bullet style preset. Use NONE to remove bullets. Default: BULLET_DISC_CIRCLE_SQUARE
documentIdstringyesThe document ID
endIndexnumber–End index (exclusive) - use with startIndex
ifRevisionIdstring–Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
matchInstancenumber–Which instance of textToFind (default: 1)
startIndexnumber–Start index (1-based) - use with endIndex
tabIdstring–Optional. Tab ID to operate within (from listDocumentTabs). If omitted, operates on the first/default tab.
textToFindstring–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.

NameTypeReqDescription
accountstring–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.
parentFolderIdstring–ID or path of the folder where the shortcut will be created
shortcutNamestring–Custom name for the shortcut (defaults to original file name)
targetFileIdstringyesThe 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

NameTypeReqDescription
accountstring–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.
contentstringyesFile content
namestringyesFile name (.txt or .md)
parentFolderIdstring–Parent folder ID

No output schema declared.

No examples provided.

deleteCalendarEvent ~95

Delete a calendar event

NameTypeReqDescription
accountstring–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.
calendarIdstring–Calendar ID (default: primary)
eventIdstringyesThe event ID to delete
sendUpdatesstring–Send cancellation notifications (default: none)

No output schema declared.

No examples provided.

deleteComment ~78

Delete a comment from the document

NameTypeReqDescription
accountstring–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.
commentIdstringyesThe comment ID to delete
documentIdstringyesThe 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.

NameTypeReqDescription
accountstring–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.
dimensionstringyesGroup rows or columns
endIndexnumberyes0-based end index (exclusive); must be greater than startIndex
sheetIdnumberyesSheet ID (from getSpreadsheetInfo / listSheets). The default first sheet is usually 0.
spreadsheetIdstringyesSpreadsheet ID
startIndexnumberyes0-based start index (inclusive)

No output schema declared.

No examples provided.

deleteGoogleSlide ~77

Delete a slide from a presentation

NameTypeReqDescription
accountstring–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.
presentationIdstringyesPresentation ID
slideObjectIdstringyesSlide 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)

NameTypeReqDescription
accountstring–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.
itemIdstringyesID 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.

NameTypeReqDescription
accountstring–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.
documentIdstringyesThe Google Doc or text file ID
endIndexnumber–End index (exclusive). Google Docs: 1-based Docs API structural index. Text files: 0-based Unicode code point (character) offset.
ifRevisionIdstring–Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
matchInstancenumber–Which instance of textToFind (default: 1)
startIndexnumber–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.
tabIdstring–Optional. Google Docs only — Tab ID to delete from (from listDocumentTabs). If omitted, deletes from the first/default tab. Not supported on text files.
textToFindstring–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

NameTypeReqDescription
accountstring–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.
sheetIdnumberyesSheet ID
spreadsheetIdstringyesSpreadsheet ID

No output schema declared.

No examples provided.

deleteSlideElement ~88

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

NameTypeReqDescription
accountstring–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.
objectIdstringyesElement object ID to delete
presentationIdstringyesPresentation 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.

NameTypeReqDescription
accountstring–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.
documentIdstringyesThe document ID
endIndexnumber–End index (exclusive). Defaults to startIndex + 1. Only with startIndex.
matchInstancenumber–Which occurrence of textToFind (1-based, default 1)
startIndexnumber–Start index (1-based). Use this or textToFind.
tabIdstring–Optional. Tab to probe (from listDocumentTabs). If omitted, uses the first/default tab.
textToFindstring–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.

NameTypeReqDescription
accountstring–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.
exportMimeTypestring–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.
fileIdstringyesGoogle Drive file ID
localPathstringyesAbsolute 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.
overwriteboolean–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

NameTypeReqDescription
accountstring–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.
presentationIdstringyesPresentation ID
slideObjectIdstringyesSlide 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.

NameTypeReqDescription
accountstring–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.
alignmentstring–Text alignment
boldboolean–Make text bold
columnIndexnumberyesColumn index (0-based)
documentIdstringyesThe document ID
fontSizenumber–Font size in points
ifRevisionIdstring–Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
italicboolean–Make text italic
rowIndexnumberyesRow index (0-based)
tabIdstring–Optional. Tab ID containing the table (from listDocumentTabs). If omitted, operates on the first/default tab.
tableStartIndexnumberyesThe starting index of the TABLE element
textContentstring–New text content for the cell (replaces existing)

No output schema declared.

No examples provided.

exportSlideThumbnail ~96

Export a slide thumbnail URL

NameTypeReqDescription
accountstring–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.
mimeTypestring–Thumbnail MIME type
presentationIdstringyesPresentation ID
sizestring–Thumbnail size
slideObjectIdstringyesSlide 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.

NameTypeReqDescription
accountstring–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.
documentIdstringyesThe document ID
dryRunboolean–Only count matches, do not modify the document (default: false). Respects tabId scoping.
expectedCountnumber–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…
findTextstringyesText to find
ifRevisionIdstring–Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
matchCaseboolean–Case-sensitive match (default: false)
replaceTextstringyesReplacement text
tabIdstring–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.

NameTypeReqDescription
accountstring–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.
alignmentstring–Text alignment
avoidWidowAndOrphanboolean–Avoid widow and orphan lines
borderBetweenobject–Border between consecutive same-styled paragraphs. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
borderBottomobject–Border below the paragraph (a horizontal rule). Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
borderLeftobject–Border left of the paragraph. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
borderRightobject–Border right of the paragraph. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
borderTopobject–Border above the paragraph. Omitted subfields default to a rendering border: color #000000, width 1pt, padding 1pt, SOLID.
documentIdstringyesThe document ID
endIndexnumber–End index (exclusive) - use with startIndex
ifRevisionIdstring–Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
indentEndnumber–Right indent in points
indentFirstLinenumber–First-line indent in points
indentStartnumber–Left indent in points
indexWithinParagraphnumber–Any index within the target paragraph
keepLinesTogetherboolean–Keep all lines of the paragraph on one page
keepWithNextboolean–Keep with next paragraph
matchInstancenumber–Which instance of textToFind (default: 1)
namedStyleTypestring–Named paragraph style
pageBreakBeforeboolean–Start the paragraph on a new page
removeBordersarray–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…
removeShadingboolean–Clear the paragraph background shading
shadingstring–Paragraph background color as hex (e.g., #F1F3F4)
spaceAbovenumber–Space above in points
spaceBelownumber–Space below in points
startIndexnumber–Start index (1-based) - use with endIndex
tabIdstring–Optional. Tab ID to format within (from listDocumentTabs). If omitted, operates on the first/default tab.
textToFindstring–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.

NameTypeReqDescription
accountstring–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.
backgroundColorstring–Hex background color
baselineOffsetstring–Vertical text offset: SUPERSCRIPT or SUBSCRIPT. Use NONE to reset text to the normal baseline.
boldboolean–Make text bold
documentIdstringyesThe document ID
endIndexnumber–End index (exclusive) - use with startIndex
fontFamilystring–Font family name
fontSizenumber–Font size in points
foregroundColorstring–Hex color (e.g., #FF0000)
ifRevisionIdstring–Optional optimistic lock: a revisionId from readGoogleDoc, getGoogleDocContent, getGoogleDocContentPaginated, or getDocumentInfo. The write fails cleanly if the document changed since that read. Vali…
italicboolean–Make text italic
linkUrlstring–URL for hyperlink
matchInstancenumber–Which instance of textToFind (default: 1)
startIndexnumber–Start index (1-based) - use with endIndex
strikethroughboolean–Strikethrough text
tabIdstring–Optional. Tab ID to format within (from listDocumentTabs). If omitted, operates on the first/default tab.
textToFindstring–Text to find and format (alternative to indices)
underlineboolean–Underline text

No output schema declared.

No examples provided.

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.

npm · @piotr-agier/google-drive-mcp

# add to Claude Code
claude mcp add piotr-agier-google-drive-mcp -- npx -y @piotr-agier/google-drive-mcp
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 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.