Log inSubmit server
MCP Gdrive logo

MCP Gdrive

by isaacphi

Connects Google Drive and Sheets to MCP clients for file search, file reading, spreadsheet reads, and cell updates.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Gdrive

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": {
    "isaacphi-mcp-gdrive": {
      "command": "npx",
      "args": [
        "-y",
        "@isaacphi/mcp-gdrive"
      ],
      "env": {
        "GDRIVE_CREDS_DIR": "YOUR_VALUE_HERE",
        "CLIENT_ID": "YOUR_VALUE_HERE",
        "CLIENT_SECRET": "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

The install command started, but didn't respond the way we expected when we tried to talk to it.

npx -y @isaacphi/mcp-gdrive

initialize succeeded but no response to tools/list.

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 14d ago.

Overview

The isaacphi/mcp-gdrive MCP server connects MCP clients to Google Drive and Google Sheets. It lets agents search and read Drive files, retrieve spreadsheet data, and update individual spreadsheet cells. Google Workspace files exposed as Drive resources are converted to usable formats such as Markdown, CSV, plain text, or PNG. Reach for it when an agent needs authenticated access to Drive content or spreadsheet data through a standard desktop MCP configuration.

Use cases

  • Search Drive for documents by query
  • Read the contents of a Drive file
  • Extract data from a spreadsheet range
  • Update a Google Sheets cell

Key features

  • Search Google Drive files
  • Read Google Drive file contents
  • Read full sheets or A1 ranges
  • Update spreadsheet cell values
  • Expose Drive files as MCP resources
  • Convert Google Workspace files on access

Tools2

What MCP Gdrive 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 Today

Recent health check succeeded.

21/21 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @isaacphi/mcp-gdrive (npm)

Adoption & maintenance

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

GitHub stars282Stargazers on the source repository.
npm downloads23kPackage downloads in the last 30 days.
Last commit1y agoMost recent push to the default branch.
Install checkInconclusiveStarted but did not complete the MCP handshake in our test.
Tools exposed2Callable tools this server registers over MCP.
Directory activity4 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Gdrive works

What isaacphi/mcp-gdrive MCP server does

The isaacphi/mcp-gdrive MCP server exposes Google Drive and Google Sheets operations through MCP. It supports finding files, reading file contents, reading spreadsheet data, and changing a cell value. The available operations are useful for agents that need to locate documents before inspecting them or work with structured data stored in Sheets.

Drive files are also available as MCP resources using the gdrive:///<file_id> URI pattern. Workspace files are converted when accessed: Google Docs become Markdown, Sheets become CSV, Presentations become plain text, and Drawings become PNG images. Other files are returned in their native format.

How it works

The server uses Google OAuth authentication. A Google Cloud project must have the Drive API enabled, and the setup also requires the Sheets API and Docs API for Sheets and Docs interaction. The configured OAuth client is used to authorize an account, and the resulting token is stored in the configured credentials directory.

Its four tools accept focused inputs. gdrive_search takes a search string and optional pagination settings, with a maximum page size of 100, and returns matching file names and MIME types. gdrive_read_file reads a file by ID. gsheets_read can read a full sheet or selected A1 ranges, with an optional sheet ID. gsheets_update_cell writes a string value to an A1-style cell range.

Setup and configuration

To configure the isaacphi/mcp-gdrive MCP server, create a Google Cloud project, enable the required APIs, configure an OAuth consent screen, and create a Desktop App OAuth client. The OAuth scopes listed by the project are Drive read-only access and Sheets access. Download the client key file, rename it to gcp-oauth.keys.json, and place it in the directory selected by GDRIVE_CREDS_DIR.

The server expects these environment variables:

  • GDRIVE_CREDS_DIR: Directory containing the OAuth key file and saved token.
  • CLIENT_ID: Google OAuth client ID.
  • CLIENT_SECRET: Google OAuth client secret.

Build the project with npm run build or npm run watch. Running node ./dist/index.js starts the browser-based authentication flow. The authenticated account must belong to the same organization as the Google Cloud project. A desktop MCP client can launch the package with npx -y @isaacphi/mcp-gdrive and pass the three variables in its server configuration.

Tools and capabilities

  • Search Drive files with optional pagination.
  • Read file contents by Google Drive file ID.
  • Read complete spreadsheets or selected A1 ranges.
  • Select a spreadsheet tab by numeric sheet ID when reading.
  • Update a specified spreadsheet cell or range with a string value.
  • Access Drive files as MCP resources with Workspace format conversion.

Limitations and notes

The server requires Google Cloud and OAuth setup before use. Drive search returns file names and MIME types rather than full file contents; reading requires a separate file ID. Spreadsheet updates accept a string value and target an A1-notation range. The documented OAuth configuration includes drive.readonly, so the write operation applies to Sheets through the separately configured Sheets scope rather than general Drive file writes.

The project is licensed under the MIT License. Its desktop configuration uses a local process launched with npx, and the OAuth token is persisted under the credentials directory supplied by the user.

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 MCP Gdrive

isaacphi/mcp-gdrive is an MCP server that connects AI clients to Google Drive and Google Sheets. Its main tools search Drive files, read file contents, read spreadsheet data or ranges, and update spreadsheet cells. It also exposes Drive files as resources, converting supported Google Workspace formats for access.

Install it by building the project with `npm run build` or `npm run watch`, then configure an MCP client to launch `npx -y @isaacphi/mcp-gdrive`. Before use, create the required Google Cloud OAuth configuration and provide `CLIENT_ID`, `CLIENT_SECRET`, and `GDRIVE_CREDS_DIR`.

Authenticate by running `node ./dist/index.js` after configuring the OAuth credentials. The command opens a browser authentication flow, and the token is saved under `GDRIVE_CREDS_DIR`. The account used must belong to the same organization as the Google Cloud project.

Yes, it can update a Google Sheets cell or range with `gsheets_update_cell`. The tool requires the spreadsheet ID, an A1-notation range such as `Sheet1!A1`, and the new value as a string. The Google Sheets API and the Sheets OAuth scope must be configured.

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