Skip to content

Working with clients? Stay ahead of what they ask for.

CommunityFilesystem

Google Drive MCP

by piotr-agier

Google Drive MCP server. Covers Drive plus Docs, Sheets, Slides, and Calendar. OAuth 2.0 with token storage and revocation flows. File revisions tools added in v1.7.0.

★ 140·8 listed tools·Released JUL 2025·MIT
npx -y @piotr-agier/google-drive-mcp
Share:

“Active maintenance: 20 commits on main in the last 30 days, 20 releases shipped, latest 9 days old. Covers Drive plus Docs, Sheets, Slides, and Calendar through one MCP. Picks the filesystem slot for cloud-backed file ops. Pair with the Google Workspace MCP (taylorwilsdon, Batch 5) when you want full Workspace coverage including Gmail and Forms; pick this when the file-system framing matters more than productivity-app coverage.”

Reviewed by M. Nouriel · MAY 2026

INSTALL THIS SERVER

Requires authenticationGoogle OAuth 2.0. Requires a Google Cloud Console OAuth client and credentials.json. Token storage is local; revocation flows documented.
{ "mcpServers": { "google-drive": { "command": "npx", "args": [ "-y", "@piotr-agier/google-drive-mcp" ] } } }
PrereqRequires Node.js 18+ and a Google Cloud Console OAuth 2.0 client (credentials.json). On first run, the server opens a browser for OAuth consent and stores tokens locally. NPM package: `@piotr-agier/google-drive-mcp`. Docker image available as alternative. Path: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS).
{ "mcpServers": { "google-drive": { "command": "npx", "args": [ "-y", "@piotr-agier/google-drive-mcp" ] } } }
{ "mcpServers": { "google-drive": { "command": "npx", "args": [ "-y", "@piotr-agier/google-drive-mcp" ] } } }
{ "mcpServers": { "google-drive": { "command": "npx", "args": [ "-y", "@piotr-agier/google-drive-mcp" ] } } }
{ "mcpServers": { "google-drive": { "command": "npx", "args": [ "-y", "@piotr-agier/google-drive-mcp" ] } } }

8 SELECTED TOOLS

search
Query Drive across files and folders with optional raw Drive API operators
Read
listFolder
List contents of a folder
Read
createTextFile
Create a text or markdown file
Write
updateTextFile
Update existing text file content
Write
shareFile
Share file with a user email (idempotent helper)
Admin
addPermission
Add a new permission to a file or folder
Admin

OUR ASSESSMENT

TypeScript Google Drive MCP. MIT, distributed via npm @piotr-agier/google-drive-mcp. 140 GitHub stars, 76 forks. Latest release v2.2.0 (2026-04-21), 20 releases shipped, 20 commits on main in the last 30 days. OAuth 2.0 with token storage and revocation flows. Stdio and Streamable HTTP transports. Docker image plus npx install.

Strengths
  • 20 commits on main in the last 30 days.
  • 20 releases shipped; latest v2.2.0 (2026-04-21).
  • Covers Drive plus Docs, Sheets, Slides, Calendar in one server.
  • Sharing and permissions tools include idempotent helper shareFile.
  • File revisions with safety-confirmed restoreRevision (added in v1.7.0).
  • MIT licence.
  • Stdio plus Streamable HTTP transports.
  • Docker image plus npx one-line install.
Weaknesses
  • Single-maintainer governance.
  • 140 stars; community traction is modest.
  • OAuth setup carries the standard friction of a Google Cloud Console project plus credentials.json.
Security Notes

OAuth 2.0 flow stores tokens locally; revocation flows are documented. Scope the OAuth client to the minimum required (read-only for query-only agents). For shared environments, run in HTTP mode behind a reverse proxy with TLS and authentication middleware. Token storage is local; re-authentication is manual when scopes change.

Best For

Teams wanting AI agents to manage files, folders, and permissions across Google Drive; workflows that span Drive plus Docs, Sheets, Slides, Calendar through a single MCP; file-revision recovery flows (getRevisions, restoreRevision with safety confirmation).

TECHNICAL DETAILS

Language
typescript
Transport
stdiostreamable-http
Clients
Claude DesktopClaude CodeCursorVS CodeWindsurf
License
MIT
npm
@piotr-agier/google-drive-mcp
Last Release
v2.2.0APR 21, 2026
First Released
JUL 29, 2025

RECORDED ADOPTION METRICS

Saved directory snapshots. Record last checked MAY 1, 2026. The review date above does not refresh these figures.

// GitHub Stars
140

// Recorded note140 stars and 76 forks. The fork-to-star ratio (54%) and 20 releases in 9 months carry the editorial weight beyond raw star count.

// Popularity Rank
#18
Recorded directory rank · #2 in Filesystem

// Recorded noteSecond-ranked in filesystem (after the original Filesystem reference). Pair with Google Workspace MCP for full coverage including Gmail and Forms.

SOURCES & RECORDED CHECKS

These are the directory listings and check details held in this record. Client compatibility, directory listings and installation testing are separate signals. Recorded client names describe the scope of a check; they do not establish a security assessment or a recurring test schedule.

01
Discovered
Source not recorded
First indexed MAY 1, 2026
02
Directory listings
5 directories
PulseMCP, MCP.so, Glama, Smithery, Official MCP Registry
03
Recorded client testing
Claude Desktop, Cursor, VS Code
Check current setup against the provider documentation
04
Record last checked
MAY 1, 2026
Record date; functional retest scope may differ
// How other directories see it

The same server, 5 different lenses. We reconcile these signals into our editorial score, which is why our number sometimes diverges from a directory-aggregate star count.

SourceTheir ratingTheir star countTheir downloadsLast synced
AutomationSwitch This page4.1editorial140—MAY 1, 2026
PulseMCP— unratedunavailableunavailableMAY 1, 2026
MCP.so— unratedunavailableunavailableMAY 1, 2026
Glama— unratedunavailableunavailableMAY 1, 2026
Smithery— unratedunavailableunavailableMAY 1, 2026
Official MCP Registry— unratedunavailableunavailableMAY 1, 2026

// Counts are directory-reported; we don't adjust them. Discrepancies usually come from different snapshot times or star-caching.

// Get in touch

DISCUSS YOUR
MCP REQUIREMENTS.

Evaluating a server, scoping an internal deployment, or working out whether MCP is the right fit at all. Start the conversation and we will point you at the right piece of the ecosystem.

Discuss Your MCP Requirements →