Google Drive MCP Server

by us-allio.github.us-all/google-drivev1.15.8

Google Drive + Workspace MCP — Docs, Sheets, Slides, Shared Drives, Labels, Approvals, DWD

0Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing3mo ago

Install Google Drive MCP server

claude mcp add google-drive-us-all -e GOOGLE_CLIENT_ID='<google-client-id>' -e GOOGLE_CLIENT_SECRET='<google-client-secret>' -e GOOGLE_REFRESH_TOKEN='<google-refresh-token>' -- npx -y @us-all/google-drive-mcp

{
  "mcpServers": {
    "google-drive-us-all": {
      "command": "npx",
      "args": [
        "-y",
        "@us-all/google-drive-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<google-client-id>",
        "GOOGLE_CLIENT_SECRET": "<google-client-secret>",
        "GOOGLE_REFRESH_TOKEN": "<google-refresh-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "google-drive-us-all": {
      "command": "npx",
      "args": [
        "-y",
        "@us-all/google-drive-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<google-client-id>",
        "GOOGLE_CLIENT_SECRET": "<google-client-secret>",
        "GOOGLE_REFRESH_TOKEN": "<google-refresh-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "google-drive-us-all": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@us-all/google-drive-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<google-client-id>",
        "GOOGLE_CLIENT_SECRET": "<google-client-secret>",
        "GOOGLE_REFRESH_TOKEN": "<google-refresh-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "google-drive-us-all": {
      "command": "npx",
      "args": [
        "-y",
        "@us-all/google-drive-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<google-client-id>",
        "GOOGLE_CLIENT_SECRET": "<google-client-secret>",
        "GOOGLE_REFRESH_TOKEN": "<google-refresh-token>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
GOOGLE_CLIENT_ID	—	yes	OAuth client ID. Required for OAuth refresh-token auth method.
GOOGLE_CLIENT_SECRET	—	yes	OAuth client secret. Required for OAuth refresh-token auth method.
GOOGLE_REFRESH_TOKEN	—	yes	OAuth refresh token. Required for OAuth refresh-token auth method.
GOOGLE_APPLICATION_CREDENTIALS	—	—	Path to service account JSON key. Required for SA + DWD auth method (alternative to OAuth).
GOOGLE_SERVICE_ACCOUNT_KEY_PATH	—	—	Alias for GOOGLE_APPLICATION_CREDENTIALS.
GOOGLE_IMPERSONATE_USER	—	—	Workspace user email to impersonate (DWD). Required when using service account auth.
GOOGLE_DRIVE_SCOPES	—	—	Comma-separated OAuth scopes. Defaults are read-only; write mode broadens Drive/Docs scopes as needed.
GOOGLE_DRIVE_ALLOW_WRITE	—	—	Set to 'true' to enable write tools. Default read-only.
GD_TOOLS	—	—	Comma-separated category allowlist. Default: all categories enabled.
GD_DISABLE	—	—	Comma-separated category disablelist.

Freshness

Slowing — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-10 · 3mo ago · GitHub
Latest release
2026-06-19 · 4mo ago · GitHub · v1.15.8
Package published
no data · npm/PyPI
Registry entry updated
2026-06-19 · 4mo ago · official registry · v1.15.8

FAQ

›How do I install the Google Drive MCP server in Claude Code?

Run: claude mcp add google-drive-us-all -e GOOGLE_CLIENT_ID='<google-client-id>' -e GOOGLE_CLIENT_SECRET='<google-client-secret>' -e GOOGLE_REFRESH_TOKEN='<google-refresh-token>' -- npx -y @us-all/google-drive-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Google Drive require an API key?

Yes. It expects GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN, of which 3 are secrets.

›Can I use Google Drive as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Google Drive in the official MCP registry?

Yes, as io.github.us-all/google-drive.

Install Google Drive MCP server

Install in Claude Code

Install in Cursor

Install in Claude Desktop

Install in VS Code

Install in Windsurf

Configuration

Freshness

FAQ

Alternatives to Google Drive