Google Drive MCP server

Read from the package source without running it. The installed server may list more.

• addComment

  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.

• addDataValidation

  Add data validation rules to a sheet range

• addDimensionGroup

  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) \u2014 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.

• addDocumentTab

  Add a new tab in a Google Doc

• addGoogleSheetConditionalFormat

  Add conditional formatting to a Google Sheet

• addNamedRangewrite action

  Create a named range

• addPermission

  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'.

• addSheet

  Alias for addSpreadsheetSheet (adds a new sheet/tab)

• addSpreadsheetSheet

  Adds a new sheet/tab to an existing Google Spreadsheet

• appendSpreadsheetRows

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

• applyParagraphStyle

  Apply paragraph formatting \u2014 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.

• applyTextStyle

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

• authGetStatus

  Show authentication/token status and scope diagnostics

• authListScopes

  List configured/requested scopes and currently granted scopes

• authTestFileAccesswrite action

  Run auth diagnostics against Drive API/file access

• autoResizeColumns

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

• autoResizeRows

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

• batchUpdateGoogleSheetValueswrite action

  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.

• bulkConvertFolderPdfs

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

• convertPdfToGoogleDoc

  Convert an existing PDF in Drive into an editable Google Doc

• copyFilewrite action

  Creates a copy of a Google Drive file or document

• createDocFromHTMLwrite action

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

• createFolderwrite action

  Create a new folder in Google Drive

• createFootnotewrite action

  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.

• createGoogleDocwrite action

  Create a new Google Doc

• createGoogleSheetwrite action

  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.

• createGoogleSlideswrite action

  Create a new Google Slides presentation

• createParagraphBulletswrite action

  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.

• createShortcutwrite action

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

• createTextFilewrite action

  Create a new text or markdown file

• deleteCommentwrite action

  Delete a comment from the document

• deleteDimensionGroupwrite action

  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 partial

• deleteItemwrite action

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

• deleteRangewrite action

  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 \u2

• deleteSheetwrite action

  Delete a sheet/tab by sheetId

• describeGoogleDocRange

  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,

• downloadFile

  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.

• editTableCell

  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.

• findAndReplaceInDoc

  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

• formatGoogleDocParagraph

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

• formatGoogleDocText

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

• formatGoogleSheetCells

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

• formatGoogleSheetNumbers

  Apply number formatting to cells in a Google Sheet

• formatGoogleSheetText

  Apply text formatting to cells in a Google Sheet

• getComment

  Get a specific comment with its full thread of replies

• getDocumentInfo

  Gets detailed information about a specific Google Document.

• getGoogleDocContent

  Get content of a Google Doc with text indices for formatting

• getGoogleDocContentPaginated

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

• getGoogleDocImage

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

• getGoogleDocStyleSummary

  Compact style inventory of a whole document in a few hundred tokens: fonts with their size ladders, named-style counts, text colors, bordered and shaded paragraph locations, a table inventory with real index ranges, and the heading outline. The cheap first read before any formatting work, in place of pulling the full document JSON to answer style questions. Counts cover every tab; locations are pr

• getGoogleSheetCells

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

• getGoogleSheetContent

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

• getRevisions

  List revisions for a file

• getSpreadsheetInfo

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

• hideSheetDimension

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

• insertImageFromUrlwrite action

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

• insertLocalImagewrite action

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

• insertSmartChipwrite action

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

• insertTablewrite action

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

• insertTextwrite action

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

• listComments

  List all comments in a Google Document

• listDimensionGroups

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

• listDocumentTabs

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

• listFolder

  List contents of a folder (defaults to root)

• listGoogleDocs

  Lists Google Documents from your Google Drive with optional filtering.

• listGoogleSheets

  Lists Google Spreadsheets from your Google Drive with optional filtering

• listPermissions

  List sharing permissions for a file

• listSharedDrives

  List available Google Shared Drives

• listSheets

  List tabs/sheets in a Google Spreadsheet

• lockFile

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

• manage_accounts

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

• mergeGoogleSheetCells

  Merge cells in a Google Sheet

• moveItem

  Move a file or folder

• protectRange

  Protect a range in a spreadsheet

• readGoogleDoc

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

• readGoogleDocPaginated

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

• readSmartChips

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

• readTextFile

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

• removePermissionwrite action

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

• renameDocumentTab

  Rename an existing Google Doc tab

• renameItem

  Rename a file or folder

• renameSheet

  Rename a sheet/tab by sheetId

• replyToComment

  Add a reply to an existing comment

• restoreRevision

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

• search

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

• setColumnWidth

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

• setGoogleSheetBorders

  Set borders for cells in a Google Sheet

• setRowHeight

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

• shareFile

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

• showSheetDimension

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

• styleDocTable

  Style a Docs table in one atomic call: cell borders/background/padding/content alignment (whole table via tableStartLocation, or a cell range subset), fixed column widths, and minimum row heights. Get the real tableStartIndex from the table span line readGoogleDoc or getGoogleDocContent prints (tableStartIndex=N) \u2014 never compute it from text offsets. removeBorders: ["all"] unboxes the table (

• unlockFile

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

• updateDimensionGroupwrite action

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

• updateGoogleDocwrite action

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

• updateGoogleSheetwrite action

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

• updateGoogleSheetIfUnchangedwrite action

  Write cell values only if the guarded area has not changed since you read it, and get back what was overwritten so the change can be undone. Call once with dryRun:true to obtain the fingerprint, then again passing it as expectedFingerprint. IMPORTANT: this is optimistic and NOT atomic. The Sheets API has no compare-and-swap - unlike Docs, where ifRevisionId is enforced by the API itself - so the c

• updatePermissionwrite action

  Update an existing permission role

• updateTextFilewrite action

  Update an existing text or markdown file

• uploadFilewrite action

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

• uploadPdfWithSplitwrite action

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

• Code scan2 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitystatic API keys via environment variables6/15
• Maintenancelast push 0 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Safety score

83/100

higher than 60% of 1,299 Productivity servers

Tools

100

the typical Productivity server has 7

Tools that change things

32%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

226

more than 95% of 854 Productivity servers

Google Drive MCP: common questions

Is Google Drive MCP server safe?

Mostly: it is graded B (83/100). Read the Google Drive MCP safety report

How do I install Google Drive MCP?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does Google Drive MCP need an API key?

Yes. The registry entry asks for GOOGLE_DRIVE_OAUTH_CREDENTIALS.

Is Google Drive MCP maintained?

The last commit was 20 days ago (2026-10-15). The latest release is v2.12.0.

What can I use instead of Google Drive MCP?

Servers from other publishers that do the same job: Agent-Native Calendar MCP server, gflow-cli MCP server and Gsheets MCP server. Compare all Google Drive MCP alternatives.

How does Google Drive MCP compare with other Productivity MCP servers?

safety score 83/100 (higher than 60% of 1,299 Productivity servers); tools 100 (the typical Productivity server has 7); tools that change things 32% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.