gh-warrenzhu050413-warren-claude-code-plugin-marketplace-claude-context-orchestrator/skills/GCLOUD.md

REF--- name: GCLOUD description: Google Cloud credentials setup and management for Google Drive/Gmail integration keywords: google, gcloud, credentials, oauth, drive, gmail, api location: /Users/wz/.claude/plugins/marketplaces/warren-claude-code-plugin-marketplace/claude-context-orchestrator/skills/GCLOUD.md

Google Cloud Credentials Setup

How Credentials Were Located

Discovery Process

1. User mentioned Gmail MCP was already configured

   • Checked Claude Desktop config at /Users/wz/.claude.json
   • Found Gmail MCP server configuration:

   "@gongrzhe/server-gmail-autoauth-mcp": {
     "env": {
       "GMAIL_OAUTH_PATH": "/Users/wz/Desktop/OAuth2/gcp-oauth.keys.json",
       "GMAIL_CREDENTIALS_PATH": "/Users/wz/.gmail-mcp/credentials.json"
     }
   }
   

2. Located OAuth Credentials

   • Path: /Users/wz/Desktop/OAuth2/gcp-oauth.keys.json
   • Size: 412 bytes
   • Created: Sep 24 16:12
   • Contains: OAuth 2.0 client credentials from Google Cloud Console

3. Located Stored Token

   • Path: /Users/wz/.gmail-mcp/credentials.json
   • Size: 552 bytes
   • Created: Sep 26 03:44
   • Contains: Authenticated user token (access + refresh tokens)

File Locations

# OAuth Client Credentials (from Google Cloud Console)
/Users/wz/Desktop/OAuth2/gcp-oauth.keys.json

# Authenticated User Token (after OAuth flow)
/Users/wz/.gmail-mcp/credentials.json

# Token for Drive API (auto-created by gdrive_sync.py)
/tmp/token.pickle

Using Credentials for Google Drive

Setup Script

# /tmp/gdrive_sync.py uses these credentials

# 1. Looks for credentials.json (OAuth client config)
CREDENTIALS_FILE = '/tmp/credentials.json'  # Copy of gcp-oauth.keys.json

# 2. Creates/uses token.pickle (authenticated session)
TOKEN_FILE = 'token.pickle'  # Created after first auth

Integration Steps

1. Copy OAuth credentials to working directory:

   cp /Users/wz/Desktop/OAuth2/gcp-oauth.keys.json /tmp/credentials.json
   

2. First-time authentication (creates token.pickle):

   cd /tmp
   python3 gdrive_sync.py /path/to/file.md
   # Opens browser → Login to Google → Grant permissions
   # Creates token.pickle for future use
   

3. Subsequent uses (automatic):

   python3 gdrive_sync.py /path/to/file.md
   # Uses existing token.pickle, no browser needed
   

API Scopes

Gmail MCP Scopes

https://www.googleapis.com/auth/gmail.readonly
https://www.googleapis.com/auth/gmail.send
https://www.googleapis.com/auth/gmail.compose

Drive API Scopes (used by gdrive_sync.py)

https://www.googleapis.com/auth/drive.file

Note: Different scopes = Different tokens needed

• Gmail token: /Users/wz/.gmail-mcp/credentials.json
• Drive token: /tmp/token.pickle

Quick Commands

Sync file to Google Drive

python3 /tmp/gdrive_sync.py /path/to/file.md

List files in Google Drive

python3 /tmp/gdrive_sync.py list

Via Flask Server (from browser)

// Click "📤 Sync to Drive" button in editor
// Calls: POST http://localhost:8765/sync-gdrive

Troubleshooting

"credentials.json not found"

cp /Users/wz/Desktop/OAuth2/gcp-oauth.keys.json /tmp/credentials.json

"Token expired"

rm /tmp/token.pickle
python3 /tmp/gdrive_sync.py /path/to/file.md
# Re-authenticates via browser

"Insufficient permissions"

# Token might have wrong scopes
rm /tmp/token.pickle
# Re-auth will request correct scopes

Architecture

User edits in Browser
    ↓
Flask Server (/tmp/skill-server.py)
    ↓
Saves to local file (/tmp/skills/SKILL.md)
    ↓
Calls gdrive_sync.py
    ↓
Uses OAuth credentials (gcp-oauth.keys.json)
    ↓
Google Drive API
    ↓
Uploads to Google Drive (Skills folder)

Files Created

/tmp/
├── credentials.json          # OAuth client config (copied)
├── token.pickle             # Authenticated session
├── gdrive_sync.py           # Sync script
├── skill-server.py          # Flask server with /sync-gdrive endpoint
└── skill-editor-server.html # Editor with "Sync to Drive" button

Success Confirmation

When working correctly, you'll see:

✓ Folder 'Skills' created: <folder_id>
✓ Uploaded: SKILL.md (ID: <file_id>)

Check Google Drive: https://drive.google.com/drive/my-drive

• Should see "Skills" folder
• Should see uploaded .md files

References

• OAuth credentials location: /Users/wz/Desktop/OAuth2/gcp-oauth.keys.json
• Gmail MCP config: /Users/wz/.claude.json (line 1539)
• Google Drive API docs: https://developers.google.com/drive/api/v3/about-sdk
• Official Python client: https://github.com/googleapis/google-api-python-client