google-workspace-auth

Google Workspace Authentication

Re-authenticate or manage Google Workspace MCP OAuth tokens during a Claude Code session.

Quick Commands

Check Token Status

claude-mpm oauth status google-workspace-mcp

Refresh Existing Token

claude-mpm oauth refresh google-workspace-mcp

Full Re-Authentication

# Opens browser for full OAuth flow
claude-mpm oauth setup google-workspace-mcp --no-launch

# If credentials need to be re-entered
claude-mpm oauth setup google-workspace-mcp --force --no-launch

Revoke Tokens (Logout)

claude-mpm oauth revoke google-workspace-mcp

Prerequisites

Google OAuth credentials must be configured in one of:

1. .env.local (highest priority)
2. .env
3. Environment variables

# Required environment variables
GOOGLE_OAUTH_CLIENT_ID="your-client-id.apps.googleusercontent.com"
GOOGLE_OAUTH_CLIENT_SECRET="your-client-secret"

Get credentials from: https://console.cloud.google.com/apis/credentials

OAuth Callback Configuration

The OAuth callback server listens on http://127.0.0.1:8789/callback

Ensure this redirect URI is configured in your Google Cloud Console OAuth client.

Troubleshooting

Token Expired

# Try refresh first (faster, doesn't need browser)
claude-mpm oauth refresh google-workspace-mcp

# If refresh fails, do full re-auth
claude-mpm oauth setup google-workspace-mcp --no-launch

Credentials Not Found

# Force credential prompt
claude-mpm oauth setup google-workspace-mcp --force --no-launch

Check Available Services

claude-mpm oauth list

Available Google Workspace MCP Tools (34 total)

After authentication, these tools become available:

Gmail (5 tools): search_gmail_messages, get_gmail_message_content, send_email, create_draft, reply_to_email

Calendar (6 tools): list_calendars, get_events, create_event, update_event, delete_event

Drive (7 tools): search_drive_files, get_drive_file_content, list_document_comments, create_drive_folder, upload_drive_file, delete_drive_file, move_drive_file

Docs (4 tools): create_document, append_to_document, get_document, upload_markdown_as_doc

Tasks (12 tools): list_task_lists, get_task_list, create_task_list, update_task_list, delete_task_list, list_tasks, get_task, search_tasks, create_task, update_task, complete_task, delete_task, move_task