Google Services OAuth Setup with Browser Support
start_google_authIdempotent
Initiate Google OAuth2 authentication to access Google services like Drive, Gmail, and Calendar with automatic browser opening and service selection.
Instructions
Initiate Google OAuth2 authentication flow for Google services with automatic browser opening (Drive, Gmail, Docs, Sheets, Slides, Calendar, etc.)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| auth_method | No | Authentication method: - 'pkce_file': PKCE with file storage (recommended, default) - 'pkce_memory': PKCE with session-only storage - 'file_credentials': Legacy credential file method | pkce_file |
| service_name | No | Service specification for authentication. Can be: - List of service names: ['drive', 'gmail', 'calendar'] for pre-selected services - String display name: 'My Custom App' for custom labeling (no pre-selection) - None/empty: Uses common service defaults | |
| auto_open_browser | No | Automatically open browser for authentication | |
| user_google_email | No | Google email address for authentication | |
| cross_oauth_password | No | Passphrase for cross-OAuth account access. Provide this when accessing a linked account that requires a passphrase. Only alphanumeric, underscore, and hyphen allowed. | |
| show_service_selection | No | Show service selection UI before authentication |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | Additional notes or warnings about the authentication | |
| error | No | Error message if authentication failed | |
| status | Yes | Authentication status | |
| authUrl | No | OAuth2 authorization URL to open in browser for user consent | |
| message | Yes | Human-readable message describing the authentication status | |
| sessionId | No | Session UUID for this connection. Save this to reconnect with same tool state using ?uuid= parameter | |
| userEmail | Yes | Google email address being authenticated | |
| serviceName | No | List of Google services being authorized (e.g., ['drive', 'gmail', 'calendar']) | |
| instructions | No | Step-by-step instructions for completing the OAuth flow | |
| clickableLink | No | Formatted clickable link for terminal/UI display | |
| scopesIncluded | No | List of OAuth scopes being requested for the selected services |