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

1. Go to Google Cloud Console
2. Create a new project or select existing one
3. Enable the Google Drive API
4. 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

• Google Drive API Documentation
• MCP Documentation