Log inSubmit server
Google Drive MCP logo

Google Drive MCP

Connects AI clients to Google Drive for search, file management, sharing, comments, export, download, and trash operations.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Google Drive MCP

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

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "google-drive-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@a1-x-tech/mcp-google-drive@latest"
      ],
      "env": {
        "GOOGLE_DRIVE_CLIENT_ID": "YOUR_VALUE_HERE",
        "GOOGLE_DRIVE_CLIENT_SECRET": "YOUR_VALUE_HERE",
        "GOOGLE_DRIVE_REFRESH_TOKEN": "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.

Automated check passed— started and listed 21 tools correctly (7d ago).

Overview

Google Drive MCP MCP server connects AI clients to Google Drive through the Drive API and exposes tools for searching, uploading, downloading, organizing, sharing, exporting, and commenting on files. It supports My Drive and shared drives, uses OAuth with PKCE, and can guide account connection from the conversation. Reach for it when an agent needs to manage Drive files without editing document text or spreadsheet cells directly. Destructive actions distinguish reversible trashing from permanent deletion.

Use cases

  • Search Drive for project documents and summarize exported content
  • Organize older files into archive folders
  • Upload meeting notes and convert them into Google Docs
  • Share folders and manage comment threads
  • Review, restore, or permanently delete trashed files

Key features

  • Search and inspect Drive file metadata
  • Upload, download, copy, move, and rename files
  • Export Docs, Sheets, and Slides
  • Manage sharing permissions and comments
  • Trash, restore, and permanently delete files
  • Support My Drive and shared drives

Tools21

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

Verified live~6.5k 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 Today

Recent health check succeeded.

7/7 checks healthy over the last 47d

What it can do

From the 21 tools this server returned when we ran it; 21 declare their own safety hints.

Can delete or modify data · 8Writes files · 5Handles credentials · 6Makes network requests · 21Read-only tools · 10
Network at startup4 connections
Files written at startup1
Install scriptsprepare
npm provenanceNot published
Package age48 days
Maintainers1

Observed 2026-10-17 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 1d ago via OSV.dev · @a1-x-tech/mcp-google-drive@latest (npm)

Adoption & maintenance

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

npm downloads742Package downloads in the last 30 days.
Last commit20d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed21Callable tools this server registers over MCP.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Google Drive MCP works

What Google Drive MCP does

Google Drive MCP MCP server gives an AI client access to Google Drive through the Google Drive API. It covers both My Drive and shared-drive content, where each item is addressed by its Drive file ID rather than by name alone. The server supports read operations as well as changes to files, folders, permissions, comments, and trash status.

The available surface contains 21 tools spanning search and metadata, folder creation and movement, upload and download, copying, renaming, export, sharing, comments, trash, restoration, and permanent deletion. Google Docs, Sheets, and Slides are handled as complete files: the server can move, copy, share, export, or convert them, but it does not edit document text or spreadsheet cells.

How it works

Google Drive MCP MCP server authenticates against the Google Drive API using a Google account. During an interactive connection, the assistant guides the user through OAuth client setup and approval, receives Google’s redirect on 127.0.0.1, and uses PKCE. The server stores the resulting tokens, so the interactive flow does not require a configuration file or a restart.

Two access scopes are described. drive.readonly supports read access across Drive, while drive.file restricts access to files created by the application. The complete tool set requires the broader drive scope. An existing refresh-token setup can also be supplied through environment variables.

Reads may be retried after network or HTTP 5xx failures, but writes are not replayed after an uncertain failure. This avoids silently duplicating a folder, upload, or copy. Uploads through the built-in path are limited to 5 MB; larger uploads can use a resumable session through raw_request. Drive API exports are limited to 10 MB.

Setup and configuration

The package runs through Node.js 20 or newer and is available from npm as @a1-x-tech/mcp-google-drive. Add it to an MCP client with the stdio command npx -y @a1-x-tech/mcp-google-drive@latest.

For clients using preconfigured credentials, the documented variables are GOOGLE_DRIVE_CLIENT_ID, GOOGLE_DRIVE_CLIENT_SECRET, and GOOGLE_DRIVE_REFRESH_TOKEN. Alternatively, start the server and ask the assistant to connect Google Drive so the OAuth flow can be completed interactively.

The README provides setup examples for Codex, Claude Code, Claude Desktop local configurations, Cursor, and VS Code. Claude Desktop’s current extension path expects an .mcpb bundle, which this repository does not provide; local stdio configuration is documented as a fallback for builds that still support it.

Tools and capabilities

With Google Drive MCP MCP server, an agent can:

  • Search for files and inspect names, types, owners, locations, and modification dates.
  • Create folders, move items, copy files, rename them, and update metadata.
  • Upload and download content, including converting uploaded content into a Google Doc.
  • Export Google Docs, Sheets, and Slides, including exporting a Doc to Markdown.
  • Grant, modify, or revoke access and add invitation messages.
  • List, create, resolve, or delete comment threads.
  • List trashed items, restore them, move files to trash, or permanently delete them.

The server treats ordinary deletion as moving an item to the reversible trash. Google normally purges trashed items after about 30 days. Permanent deletion is exposed separately and can remove a folder subtree, so it is not bundled with the ordinary trash operation.

Limitations and notes

File names are not unique, and duplicate names are valid in Drive. Workflows should search first and use returned IDs for later operations. The server does not provide tools for editing text inside Docs or cells inside Sheets. API-created comments cannot target a precise passage in a document.

Operations that change Drive, file metadata, permissions, comments, or trash status require care. The README’s examples show confirmation before creating a folder and moving files, but the exact confirmation behavior depends on the connected AI client. Permanent deletion bypasses the trash and should be treated separately from cleanup workflows.

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 MCP

Google Drive MCP is an MCP server that connects AI clients to the Google Drive API. Its main tools search and inspect files, upload and download content, organize folders, export Docs, Sheets, and Slides, manage sharing and comments, and move files to or restore them from trash. It supports My Drive and shared drives.

Install it through an MCP client with `npx -y @a1-x-tech/mcp-google-drive@latest`. The package requires Node.js 20 or newer. After adding the stdio server, connect Google Drive from the conversation or provide the documented OAuth environment variables.

Authenticate by asking the assistant to connect Google Drive, which guides OAuth setup, handles the redirect on `127.0.0.1` with PKCE, and stores tokens. A preconfigured setup can instead use `GOOGLE_DRIVE_CLIENT_ID`, `GOOGLE_DRIVE_CLIENT_SECRET`, and `GOOGLE_DRIVE_REFRESH_TOKEN`.

Yes, Google Drive MCP works with Cursor through a stdio entry in `~/.cursor/mcp.json` on macOS or Linux, or the corresponding user directory on Windows. The configuration uses the npm package command and does not require a separate HTTP endpoint.

Yes, it has a separate permanent-deletion operation, but ordinary deletion moves files to Google Drive’s reversible trash first. Permanent deletion bypasses the trash and can remove a folder’s descendants, while trashed files are normally auto-purged by Google after about 30 days.

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 MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/google-drive-mcp?style=directory)](https://allmcps.com/mcp/google-drive-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/google-drive-mcp"><img src="https://allmcps.com/api/badge/google-drive-mcp?style=directory" alt="Google Drive MCP on AllMCPs" /></a>