Log inSubmit server
Google Drive Files MCP logo

Google Drive Files MCP

Manage Drive files, edit Sheets, and make targeted Google Docs changes through MCP tools and a standalone CLI.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Google Drive Files MCP

Pick your client, then add it in one click or paste the config.

STDIOPython
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "google-drive-files-mcp": {
      "command": "uvx",
      "args": [
        "google-drive-files-mcp"
      ],
      "env": {
        "GDRIVE_FILES_MCP_CREDENTIALS": "YOUR_VALUE_HERE",
        "GDRIVE_FILES_MCP_TOKEN": "YOUR_VALUE_HERE",
        "GDRIVE_FILES_MCP_SCOPES": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

uvx google-drive-files-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 28d ago.

Overview

The google-drive-files-mcp MCP server connects MCP clients to Google Drive, Google Sheets, and Google Docs for file operations and in-place content editing. It provides tools for searching, creating folders, moving files, resumable local uploads, spreadsheet updates, and range-scoped document changes. OAuth credentials and cached tokens authorize the server, while writes return before/after data or precise indexes where supported. Reach for it when a hosted Drive connector cannot move existing files, upload local binaries, or edit Sheets and Docs directly.

Use cases

  • Move files into an unambiguous Drive folder
  • Upload large or binary local files
  • Update Sheets ranges and formatting
  • Replace or insert text in Docs without broad formatting changes

Key features

  • Search and organize Google Drive files
  • Resumable uploads from local paths
  • Read and edit Google Sheets ranges
  • Manage Sheets tabs and formatting
  • Perform range-scoped Google Docs edits

Tools10

What Google Drive Files MCP lets your agent do. Expand a tool for its parameters.

Self-reported~26 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

7/7 checks healthy over the last 40d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 8d ago via OSV.dev · google-drive-files-mcp (PyPI)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

Last commit3mo agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed10Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Google Drive Files MCP works

What google-drive-files-mcp does

The google-drive-files-mcp MCP server exposes Google Drive, Sheets, and Docs operations through MCP, and also provides a standalone command-line interface. Drive tools can search for files and folders, create folders, move existing files, and upload local files without converting them to a Google format. Moving a file changes its parent relationship rather than creating a duplicate. Uploads use resumable media transfer and can handle large or binary files.

Google Sheets support covers reading and writing A1 ranges, appending rows, clearing values while retaining formatting, batching updates, and managing tabs. Additional tools control frozen panes, number formats, bold text, background colors, wrapping, column widths, and row heights. Google Docs operations are deliberately range-based: the server can inspect document structure, read text with character indexes, replace text, insert text around an anchor or at an index, append content, and delete a selected range.

How it works

The google-drive-files-mcp MCP server uses Google OAuth credentials and a cached refresh token. MCP clients start it with the serve command, while the CLI exposes equivalent commands for searching, moving, uploading, and editing. For Sheets and Docs changes, the relevant Google API must be enabled in the Google Cloud project.

Read operations help identify targets before writes. For example, Sheets metadata lists tab names and dimensions, while Docs reading includes segment indexes for precise edits. Several write operations return previous values, before/after parent information, or exact indexes so changes can be checked. Destructive actions such as clearing a range, deleting a tab, or deleting a Docs range have separate explicit tools.

Setup and configuration

Install with pip install google-drive-files-mcp or uv tool install google-drive-files-mcp. Create or select a Google Cloud project, enable the Drive API, and enable the Sheets and Docs APIs if those features are needed. Create a Desktop OAuth client, download its JSON credentials, and import them with google-drive-files-mcp setup --import-credentials <path>. The status command can verify the setup.

Configuration supports these environment variables:

  • GDRIVE_FILES_MCP_CREDENTIALS changes the OAuth client-secret path.
  • GDRIVE_FILES_MCP_TOKEN changes the cached token path.
  • GDRIVE_FILES_MCP_SCOPES supplies comma-separated OAuth scopes.

Claude Desktop can start the server with a command entry using google-drive-files-mcp serve; Claude Code can add the same command through its MCP configuration.

Tools and capabilities

Drive tools accept file IDs, URLs, or supported folder references. A destination folder name must be unambiguous; otherwise, use its ID. keep_existing_parents allows a move operation to add a parent without removing existing ones.

Sheets tools accept spreadsheet identifiers and A1 ranges. USER_ENTERED input interprets values such as formulas, while RAW writes values literally. Docs edits preserve unrelated content and formatting by limiting each operation to the requested range or anchor.

Limitations and notes

Moving an arbitrary existing file requires the full Google Drive scope, which grants read, write, and delete access across Drive files. The narrower drive.file scope cannot change parents for arbitrary files. Protect the cached token, which is stored with restrictive permissions, and consider using a separate OAuth client and token for this server.

The tool does not provide file rename, copy, trash, or delete operations. File copying remains available through the hosted Drive connector. Folder names must resolve to one destination, and deleting a Sheets tab or document range is destructive.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Google Drive Files MCP

google-drive-files-mcp is an MCP server that connects MCP clients to Google Drive, Google Sheets, and Google Docs. Its main tools search, create folders, move and upload Drive files, edit Sheets ranges and tabs, and make targeted Docs changes such as replacing, inserting, appending, or deleting text.

Install it with `pip install google-drive-files-mcp` or `uv tool install google-drive-files-mcp`. Then create a Google Cloud OAuth Desktop client, import its credentials with the setup command, and configure the server in your MCP client.

Yes, google-drive-files-mcp is described as working with Cursor through MCP. The server is started with its `serve` command after OAuth setup, and the client must be configured to launch that command.

It requires the Google Drive API, plus the Sheets API for spreadsheet features and the Docs API for document features. The full Drive OAuth scope authorizes access, but each API still needs to be enabled in the Google Cloud project.

Yes, it can move an existing file by changing its parent folder rather than copying it. This requires the full Google Drive scope; a destination folder name must be unambiguous, or you can provide its ID.

Related MCP servers

All in File Systems All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewGoogle Drive Files MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/google-drive-files-mcp?style=directory)](https://allmcps.com/mcp/google-drive-files-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/google-drive-files-mcp"><img src="https://allmcps.com/api/badge/google-drive-files-mcp?style=directory" alt="Google Drive Files MCP on AllMCPs" /></a>