← Index

io.github.us-all/google-drive

io.github.us-all/google-drive·v1.15.0·Documents & Spreadsheets
Quality Score
85
/100

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

§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": [
        "-y",
        "@us-all/google-drive-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<your-google_client_id>",
        "GOOGLE_CLIENT_SECRET": "<your-google_client_secret>",
        "GOOGLE_REFRESH_TOKEN": "<your-google_refresh_token>",
        "GOOGLE_APPLICATION_CREDENTIALS": "<google_application_credentials>",
        "GOOGLE_SERVICE_ACCOUNT_KEY_PATH": "<google_service_account_key_path>",
        "GOOGLE_IMPERSONATE_USER": "<google_impersonate_user>",
        "GOOGLE_DRIVE_SCOPES": "<google_drive_scopes>",
        "GOOGLE_DRIVE_ALLOW_WRITE": "false",
        "GD_TOOLS": "<gd_tools>",
        "GD_DISABLE": "<gd_disable>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "google-drive": {
      "command": "npx",
      "args": [
        "-y",
        "@us-all/google-drive-mcp"
      ],
      "env": {
        "GOOGLE_CLIENT_ID": "<your-google_client_id>",
        "GOOGLE_CLIENT_SECRET": "<your-google_client_secret>",
        "GOOGLE_REFRESH_TOKEN": "<your-google_refresh_token>",
        "GOOGLE_APPLICATION_CREDENTIALS": "<google_application_credentials>",
        "GOOGLE_SERVICE_ACCOUNT_KEY_PATH": "<google_service_account_key_path>",
        "GOOGLE_IMPERSONATE_USER": "<google_impersonate_user>",
        "GOOGLE_DRIVE_SCOPES": "<google_drive_scopes>",
        "GOOGLE_DRIVE_ALLOW_WRITE": "false",
        "GD_TOOLS": "<gd_tools>",
        "GD_DISABLE": "<gd_disable>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y @us-all/google-drive-mcp
§02  Environment variables
GOOGLE_CLIENT_ID
secret

OAuth client ID. Required for OAuth refresh-token auth method.

GOOGLE_CLIENT_SECRET
secret

OAuth client secret. Required for OAuth refresh-token auth method.

GOOGLE_REFRESH_TOKEN
secret

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. Default scopes cover Drive + Docs + Sheets + Slides read/write.

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.

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
10
§04  Alternatives in Documents & Spreadsheets