What category is Google Drive MCP Server?

Google Drive is categorized under File Systems, Cloud Services. Browse more servers in these categories on MCPgee.

Google Drive

Name: Google Drive MCP Server
Author: isaacphi

v0.2.0•File Systems•stable

An actively maintained fork of the official Google Drive MCP server that enables users to search, download, and read files via the Google Drive API. It features improved OAuth token management and automatically converts Google Workspace documents int

Google DriveGoogle SheetsMCPModel Context ProtocolAI

278

Stars

Downloads

Weekly

0/5

View on GitHub

What is Google Drive?

Google Drive is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to actively maintained fork of the official google drive mcp server that enables users to search, download, and read files via the google drive api. it features improved oauth token management and automa...

This server falls under the File Systems and Cloud Services categories on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

An actively maintained fork of the official Google Drive MCP

Use Cases

Search and download files from Google Drive via Claude.

Read Google Workspace documents and convert them automatically.

Manage your Google Drive files through natural language.

isaacphi

Maintainer

LicenseMIT License

Languagetypescript

Versionv0.2.0

UpdatedMay 21, 2026

Statushealthy

Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

View Source Browse All Servers

Installation

NPM

npx -y @isaacphi/mcp-gdrive

Manual Installation

npx -y @isaacphi/mcp-gdrive

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms

ThroughputMedium

Resource Usage

Memory UsageLow

CPU UsageLow

How to Set Up and Use Google Drive

This actively maintained fork of the official Google Drive MCP server enables AI assistants to search, read, and update files stored in Google Drive through the Google Drive and Sheets APIs. It features improved OAuth token management with automatic refresh, converts Google Workspace documents (Docs, Sheets, Slides) to plain text automatically, and exposes four focused tools: file search, file reading, spreadsheet reading, and spreadsheet cell updates. Teams use it to let Claude access project documents, pull data from shared spreadsheets, or update cells without leaving the chat.

Prerequisites

A Google account with Google Drive access
A Google Cloud project with the Drive API, Sheets API, and Docs API enabled
OAuth 2.0 Desktop App credentials downloaded as gcp-oauth.keys.json
Node.js 18+ and npm
Claude Desktop or another MCP-compatible client

Create a Google Cloud project and enable APIs

Go to console.cloud.google.com, create or select a project, and enable the Google Drive API, Google Sheets API, and Google Docs API. Configure the OAuth consent screen (internal mode is sufficient for personal use).

Create OAuth credentials and download the key file

In Google Cloud Console go to APIs & Services → Credentials → Create Credentials → OAuth client ID, select Desktop App, and download the JSON file. Rename it to gcp-oauth.keys.json.

Place credentials and set GDRIVE_CREDS_DIR

Move gcp-oauth.keys.json to a secure directory (e.g. ~/.config/mcp-gdrive) and note the path — you will pass it as GDRIVE_CREDS_DIR.

mkdir -p ~/.config/mcp-gdrive
mv ~/Downloads/gcp-oauth.keys.json ~/.config/mcp-gdrive/

Authenticate via browser (first run)

Run the server once manually to complete the OAuth browser flow. A browser window will open asking you to grant Drive access. The server saves the refresh token so subsequent runs do not require re-authentication.

npx -y @isaacphi/mcp-gdrive

Add the server to Claude Desktop configuration

Add the server entry to your Claude Desktop config, supplying CLIENT_ID, CLIENT_SECRET (from the downloaded JSON), and GDRIVE_CREDS_DIR.

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@isaacphi/mcp-gdrive"],
      "env": {
        "CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "CLIENT_SECRET": "your-client-secret",
        "GDRIVE_CREDS_DIR": "/Users/you/.config/mcp-gdrive"
      }
    }
  }
}

Restart Claude Desktop and test

Restart Claude Desktop. Ask Claude to search for a file or read a document to confirm the server is working.

Google Drive Examples

Client configuration

Full Claude Desktop configuration for the Google Drive MCP server.

{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@isaacphi/mcp-gdrive"],
      "env": {
        "CLIENT_ID": "your-client-id.apps.googleusercontent.com",
        "CLIENT_SECRET": "your-client-secret",
        "GDRIVE_CREDS_DIR": "/Users/you/.config/mcp-gdrive"
      }
    }
  }
}

Prompts to try

Example prompts once the Google Drive MCP server is connected.

- "Search my Google Drive for documents about Q3 budget planning"
- "Read the contents of the file with ID 1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgVE2upms"
- "Read the data from the 'Revenue' sheet in my spreadsheet, range A1:D20"
- "Update cell B5 in my Expenses spreadsheet to 4500"
- "Find all Google Docs shared with me in the last 7 days"

Troubleshooting Google Drive

OAuth error: redirect_uri_mismatch

Ensure you created the credentials as a Desktop App type in Google Cloud Console, not a Web Application. Web App credentials use different redirect URIs and will not work with this server.

Token expired — server returns 401 Unauthorized after some time

This fork includes automatic token refresh. If you still see 401 errors, delete the token file inside GDRIVE_CREDS_DIR and re-run `npx -y @isaacphi/mcp-gdrive` manually to complete a fresh OAuth flow.

gdrive_read_file returns garbled text for Google Docs

The server automatically converts Google Workspace files (Docs, Sheets, Slides) to plain text. If the output looks garbled, the file may be in a binary format (PDF, image) rather than a native Google format. Download binary files directly from the Drive web UI instead.

Frequently Asked Questions about Google Drive

What is Google Drive?

Google Drive is a Model Context Protocol (MCP) server that actively maintained fork of the official google drive mcp server that enables users to search, download, and read files via the google drive api. it features improved oauth token management and automatically converts google workspace documents int It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Google Drive?

Install via npm with the command: npx -y @isaacphi/mcp-gdrive. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with Google Drive?

Google Drive works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Google Drive free to use?

Yes, Google Drive is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Google Drive Alternatives — Similar File Systems Servers

Looking for alternatives to Google Drive? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.

Electerm

★ 14.1k

📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)

Plik

★ 1.8k

Plik is a temporary file upload system (Wetransfer like) in Go.

Kordoc

★ 957

An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.

macOS Automator

★ 801

A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.

PDF Reader

★ 723

Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.

Filesystem MCP Server

★ 643

Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.

Browse More File Systems MCP Servers

Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

File Systems Cloud Services Browse All Servers

Set Up Google Drive in Your Editor

Choose your AI client for step-by-step setup instructions.

🖥️

Claude Desktop

macOS & Windows app

⌨️

Claude Code

CLI & terminal

📝

Cursor

AI-first code editor

💻

VS Code

GitHub Copilot MCP

🏄

Windsurf

Codeium AI editor

🔌

Cline

VS Code extension

Quick Config Preview

{
  "mcpServers": {
    "google-drive-mcp-server": {
      "command": "npx",
      "args": ["-y", "@isaacphi/mcp-gdrive"]
    }
  }
}

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Google Drive?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides

Explore All Servers Read Our Guides