Google Drive MCP Server

# 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](https://console.cloud.google.com/) 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 ```bash # 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 ```bash # 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: ```bash 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: ```json { "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](https://developers.google.com/drive) - [MCP Documentation](https://modelcontextprotocol.io)