← Back to directory
G

Google Drive MCP Server

Community
Archived
Search & read cloud documents
Category
Cloud Storage #10 of 15
Stars
★ 305 Popular
Transport
stdio (local process)
Runtime
Node.js
Credentials
API key / credential required
License
MIT
Last commit
⚠
Tools
4
55FMRS · C

Cloud-document retrieval is valuable, but OAuth setup and document exposure require strict control; community maintenance and the real authorization flow still need runtime verification.

Strongest · Reliability 13/20 Weakest · Maintenance 9/20

Reliability
13/20
Security and permissions
11/20
Maintenance
9/20
Documentation
12/20
Setup experience
10/20

Reviewed by an editorListed 2026-07-13

Read the FMRS scoring method →

Fit and risk

What it can accessReads local filesUses the network

Best for

  • Individuals or teams that need an assistant to search Google Drive documents and sheets
  • Knowledge workflows using cloud documents as grounded question-answering context

Not for

  • Highly sensitive organizations that cannot allow model processing of Drive content
  • Administrative workflows requiring full edit, sharing, or deletion controls

Required permissions

  • Google Cloud OAuth client credentials
  • Read access to the target Drive files with the corresponding read-only OAuth scope

Risks and side effects

  • Search results and document bodies may contain personal, customer, or internal data
  • Overbroad authorization can expose files unrelated to the intended workflow

Setup

Before you start

Runtime:Node.js

GDRIVE_CREDENTIALS_PATH requiredsecret Path to the Google OAuth credentials file (e.g. ./credentials.), obtained by creating an OAuth client in Google Cloud Console and downloading it.

Create OAuth credentials in Google Cloud Console, download credentials.json, and complete the authorization flow once.

claude_desktop_config.json
{
  "mcpServers": {
    "gdrive": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-gdrive"],
      "env": {
        "GDRIVE_CREDENTIALS_PATH": "./credentials.json"
      }
    }
  }
}

Shown for Claude Desktop. Other clients may use a different file or key (VS Code uses "servers") — the configurator below converts it.

.vscode/mcp.json
{
  "servers": {
    "gdrive": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gdrive"
      ],
      "env": {
        "GDRIVE_CREDENTIALS_PATH": "./credentials.json"
      }
    }
  }
}

Goes in your project's .vscode/mcp.json (VS Code uses a "servers" key).

Terminal
claude mcp add gdrive -e GDRIVE_CREDENTIALS_PATH=./credentials.json -- npx -y @modelcontextprotocol/server-gdrive

Run it in a terminal; replace any <…> placeholders with your own values first.

Check that it works

The tools search_files, read_file, list_files, and export_document should appear in the client's tool list; running list_files and getting Drive files back confirms the OAuth credentials are configured.

Troubleshooting

  1. Confirm the required API is enabled in the Google Cloud project
  2. Check OAuth consent-screen and test-user settings
  3. Delete the old token and authorize again after changing scopes

Things to try

Once connected, you can ask your AI assistant things like:

  • Search my Google Drive for files containing the project plan
  • List the recent files in my Drive
  • Read the contents of the file "meeting notes"
  • Export that Google Docs document as plain text

Tools 4

search_files read-only
Search files in Drive by content
read_file read-only
Read document or spreadsheet content
list_files read-only
List files in a folder
export_document read-only
Export a document to another format

Use cases

Find information across a team's document archive
Summarize data from multiple spreadsheets
Answer questions using source material stored in Drive

Supported clients

Claude Desktop
CursorPartial support

Listed from the project's documentation, not tested by this site.

Overview

This community-maintained server uses OAuth to access Google Drive. It supports full-text search and reading Google Docs and Sheets content so cloud documents can be used as conversational context.

Similar servers

Source revision 9be4674d1ddf Data synced 2026-10-14 Read the FMRS scoring method