Google Drive MCP Server

Google Drive and Sheets files accessible through search, read, and write operations.

Data last scanned today · Reviewed today

384 tools★ 283TypeScriptMIT

Overview

This MCP server provides a set of tools to interact with Google Drive contents directly from your AI assistant. Users can search for files by name, read file contents, and manipulate Google Sheets data. Files are accessed via the `gdrive://` resource URI. The server automatically handles conversions for Workspace files, such as exporting Docs to Markdown, Sheets to CSV, and Presentations to plain text, ensuring data is readable by the model.

Our verdict

With a security score of 38/100, this server is classified as high risk. The primary concern is the lack of a restricted read-only mode, as the configuration provides full write access to your connected Google Sheets. Because this is a community-maintained project that has not received an editorial review and has not seen a code update in over 451 days, it is recommended only for power users who understand these security implications and can properly configure OAuth scopes.

Supports OAuth authentication for secure credential management
Small footprint with only four direct dependencies
Includes automated conversion of Google Docs to Markdown
Detailed README provides clear setup instructions

No read-only mode restricts the ability to limit write permissions
Project has not been updated in over 451 days
Maintained by the community rather than the official vendor

Setup

Claude Desktop

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

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.

No read-only mode — running this grants full read/write access.
No built-in authentication — anyone with access to this config can invoke every tool it exposes.

Tools

Tool	Description	Risk
gdrive_search	Search for files in Google Drive.	low
gdrive_read_file	Read contents of a file from Google Drive.	low
gsheets_read	Read data from a Google Spreadsheet with flexible options for ranges and formatting.	low
gsheets_update_cell	Update a cell value in a Google Spreadsheet.	medium

Compatibility

Client	Local	Docker	Remote	Read-only
Claude Desktop
Cursor
VS Code
Windsurf
ChatGPT

Frequently asked questions

›What happens when I read Google Workspace files like Docs or Sheets?

Google Workspace files are automatically exported into specific formats: Docs are converted to Markdown, Sheets to CSV, presentations to plain text, and drawings to PNG.

›Which Google APIs must be enabled for this server to function?

You must enable the Google Drive API, Google Sheets API, and Google Docs API in your Google Cloud project.

›How do I authenticate with the Google Drive MCP server?

After starting the server, you will be prompted to authenticate via your browser, and the resulting OAuth token will be saved in the directory specified by your GDRIVE_CREDS_DIR environment variable.

›Are there specific OAuth scopes required for this integration?

Yes, you must configure the OAuth consent screen with the scopes https://www.googleapis.com/auth/drive.readonly and https://www.googleapis.com/auth/spreadsheets.

›Does the server allow me to modify data in my spreadsheets?

Yes, the gsheets_update_cell tool allows you to update specific cell values in a Google Spreadsheet by providing the file ID, range, and new value.

›How should I handle the OAuth credentials file?

You must rename your downloaded JSON keys file to gcp-oauth.keys.json and place it inside the directory path defined by your GDRIVE_CREDS_DIR environment variable.

Badge

Maintain this server? Add the live badge to your README.