✨ Features

Drive Operations

• 🔍 Search - Basic and advanced search with filters (MIME type, owner, dates, shared drives)
• 📄 Read - Read any file with 22+ export formats (PDF, DOCX, XLSX, Markdown, etc.)
• 📁 Create Folders - Organize files with nested folder structures
• ⬆️ Upload - Upload files up to 5MB
• 🗑️ Delete - Move files to trash
• 📦 Move - Reorganize files between folders
• 🔐 Share - Add permissions (reader, writer, commenter, owner)

Sheets Operations

• 📊 Read - Batch read multiple ranges
• ✏️ Update - Update individual cells
• ➕ Append - Add rows to spreadsheets

Infrastructure

• ☁️ Global Edge Network - Runs on Cloudflare Workers worldwide
• 🔐 OAuth 2.0 Server - Full authorization server with PKCE support
• 🔑 Dynamic Client Registration - Automatic client onboarding
• 🔄 Auto Token Refresh - Seamless Google token renewal
• 📡 SSE Transport - Real-time Server-Sent Events
• 🛡️ Secure - HTTPS only, encrypted token storage

🎯 What Makes This Different

Unlike the original STDIO-based `mcp-gdrive`, this implementation:

1. Runs remotely on Cloudflare Workers (no local process)
2. Full OAuth 2.0 authorization server (not just OAuth client)
3. Multi-client support via dynamic client registration
4. PKCE security for public clients
5. 22+ export formats for Drive files
6. Write operations (create, delete, move, share, upload)
7. Production tested with real workloads

📋 Prerequisites

Required

• Cloudflare Account with Workers enabled (free tier works)
• Google Cloud Project with Drive API and Sheets API enabled
• Node.js LTS (v18+)
• Wrangler CLI (`npm install -g wrangler`)

Google Cloud Setup

1. Create a project at Google Cloud Console
2. Enable APIs:
   • Google Drive API
   • Google Sheets API
3. Create OAuth 2.0 credentials:
   • Type: Web application
   • Redirect URIs: `https://your-worker.workers.dev/google/callback\`
4. Required OAuth scopes:
   • `https://www.googleapis.com/auth/drive\`
   • `https://www.googleapis.com/auth/spreadsheets\`

🔧 Installation & Deployment

1. Install Dependencies

```bash npm install ```

2. Create KV Namespaces

```bash

For user session tokens

wrangler kv:namespace create KV_TOKENS

For OAuth client registrations

wrangler kv:namespace create KV_CLIENTS ```

Copy the namespace IDs to `wrangler.toml`:

```toml [[kv_namespaces]] binding = "KV_TOKENS" id = "your-tokens-namespace-id"

[[kv_namespaces]] binding = "KV_CLIENTS" id = "your-clients-namespace-id" ```

3. Configure Environment Variables

Add to `wrangler.toml`:

```toml [vars] GOOGLE_CLIENT_ID = "your-client-id.apps.googleusercontent.com" ```

Set secrets:

```bash

Google OAuth client secret

wrangler secret put GOOGLE_CLIENT_SECRET ```

4. Deploy

```bash wrangler deploy ```

Your worker will be available at: `https://your-worker-name.your-account.workers.dev\`