Google Drive MCP Server

Give Claude the ability to manage your Google Drive files through the Model Context Protocol (MCP).

Available Tools

Once configured, Claude can:

create_drive_folder - Create new folders in your Drive
move_drive_file - Move files/folders between locations
rename_drive_file - Rename any file or folder
get_drive_file_info - Get metadata about files
list_drive_folder_contents - See what's inside folders

Example Usage

"Create a folder structure for organizing my Drive: Personal, Work, and Projects"

"Move all the documents with 'meeting notes' in the name to the Work folder"

"Show me what's in my root Drive folder"

Setup

Prerequisites

Python 3.10+
Google account
Claude Desktop app

1. Google Cloud Setup

Go to Google Cloud Console
Create a new project or select existing one
Enable the Google Drive API
Create OAuth 2.0 credentials:
- Go to "APIs & Services" → "Credentials"
- Click "Create Credentials" → "OAuth client ID"
- Choose "Desktop app"
- Download the JSON file

Might need to add yourself as a test user under "OAuth consent screen" tab.

2. Install Dependencies

# Clone this repository
git clone https://github.com/danbugs/google-drive-mcp.git
cd google-drive-mcp

# Create virtual environment
python -m venv venv

# Activate virtual environment
# Windows:
venv\Scripts\activate
# macOS/Linux:
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

3. Setup Credentials

# Create credentials directory
mkdir ~/.google-drive-mcp  # or %USERPROFILE%\.google-drive-mcp on Windows

# Move your downloaded credentials file
# Rename it to credentials.json and place in ~/.google-drive-mcp/

4. Test Authentication

Run the test script to complete OAuth setup:

python test_auth.py

This will open a browser window for Google authentication and create the required token.json file.

5. Configure Claude Desktop

Edit your Claude Desktop config file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/Claude/claude_desktop_config.json

Add the MCP server configuration:

{
  "mcpServers": {
    "google-drive": {
      "command": "/path/to/your/venv/bin/python",
      "args": ["/path/to/your/google_drive_mcp_server.py"]
    }
  }
}

Replace /path/to/your/ with your actual paths. On Windows, use venv\Scripts\python.exe instead.

6. Restart Claude Desktop

Quit and restart Claude Desktop, then test with:

"Can you list the contents of my Google Drive root folder?"

Security

OAuth credentials stored locally in ~/.google-drive-mcp/
Only accessible through Claude Desktop via MCP
Standard Google OAuth security model
Revoke access anytime from Google Account settings

Troubleshooting

"Credentials file not found"

Ensure credentials.json is in ~/.google-drive-mcp/
Check file permissions

"Module not found" errors

Activate the virtual environment
Re-run pip install -r requirements.txt

Claude doesn't see the tools

Verify claude_desktop_config.json syntax is valid JSON
Use absolute paths, not relative ones
Restart Claude Desktop completely
Check Claude Desktop logs: Help → "Show Logs"

Authentication issues

Delete ~/.google-drive-mcp/token.json and re-run test_auth.py
Ensure Google Drive API is enabled in Cloud Console

Resources