Google Drive MCP

Google Drive MCP

What This Does

Enables Claude Code to search, list, and read files from Google Drive.

Source

• Docker Hub: https://hub.docker.com/r/mcp/gdrive

• Docker: mcp/gdrive

• Alternative: https://github.com/felores/gdrive-mcp-server

Prerequisites

• Docker Desktop installed

• @theentourageai.com Google account

• Google Cloud Project with Drive API enabled

Step 1: Create Local Config Folder

mkdir -p ~/.config/mcp/gdrive

Step 2: Get Credentials

Create Google Cloud OAuth Credentials

1. Go to https://console.cloud.google.com

2. Log in with your @theentourageai.com account

3. Create a new project or select existing one

4. Enable required APIs:

   • Go to APIs & Services → Library

   • Enable Google Drive API

   • Enable Google Sheets API (optional, for sheet access)

   • Enable Google Docs API (optional, for doc access)

Create OAuth Client

1. Go to APIs & Services → Credentials

2. Click Create Credentials → OAuth client ID

3. Application type: Desktop app

4. Name: "Drive MCP"

5. Click Create

6. Click Download JSON

Configure OAuth Consent Screen

1. Go to APIs & Services → OAuth consent screen

2. User type: Internal (for Workspace accounts)

3. Fill in:

   • App name: "Drive MCP"

   • User support email: your @theentourageai.com email

   • Developer contact: your @theentourageai.com email

4. Add scopes:

   • https://www.googleapis.com/auth/drive.readonly

   • https://www.googleapis.com/auth/drive.file (optional, for write access)

5. Save

Step 3: Save Credentials Locally

Move the downloaded OAuth JSON file:

mv ~/Downloads/client_secret_*.json ~/.config/mcp/gdrive/credentials.json

Step 4: Pull Docker Image

docker pull mcp/gdrive

Step 5: First Run (Authentication)

Run the auth command:

docker run -it --rm \
  -v ~/.config/mcp/gdrive/credentials.json:/gcp-oauth.keys.json \
  -v ~/.config/mcp/gdrive:/mcp-gdrive \
  mcp/gdrive auth /gcp-oauth.keys.json

1. A URL will appear in terminal

2. Open URL in browser

3. Log in with your @theentourageai.com account

4. Grant permissions

5. Copy the authorization code

6. Paste it back into terminal

7. Token will be saved to ~/.config/mcp/gdrive/

Step 6: Add to Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "gdrive": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "${HOME}/.config/mcp/gdrive:/mcp-gdrive",
        "mcp/gdrive"
      ]
    }
  }
}

Note: If ${HOME} doesn't expand, use absolute path:

{
  "mcpServers": {
    "gdrive": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/Users/yourname/.config/mcp/gdrive:/mcp-gdrive",
        "mcp/gdrive"
      ]
    }
  }
}

Step 7: Verify It Works

Restart Claude Code and test:

Search my Google Drive for recent files

Expected: List of files from your Google Drive.

Available Tools

Tool	Description
search	Search files by name or content

Troubleshooting

Issue	Solution
"Access denied"	Add your email as test user in OAuth consent
"File not found"	Verify file sharing permissions
Token expired	Re-run auth command
"Insufficient permissions"	Check OAuth scopes include drive.readonly
Can't read file	Some file types may not be supported
credentials.json not found	Check file is in ~/.config/mcp/gdrive/