skills.rest
ma08
ma08COMMUNITY
Explore all skills by this author →
Website𝕏@curious_queueGitHub

gws-account-switch

Switch Google Workspace accounts for gws CLI by selecting credential files and setting environment variables.

28|Updated Jan 3, 2026
Search Tags:#gmail#drive#google-workspace#credential-management#account-switching#gws-cli
One-click install
npx skills add https://github.com/ma08/botfiles --skill gws-account-switch
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gws-account-switch
Source: https://github.com/ma08/botfiles/tree/main/claude/skills/gws-account-switch
Command: npx skills add https://github.com/ma08/botfiles --skill gws-account-switch

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Manually switching between multiple Google Workspace accounts when using the gws CLI is tedious and error-prone, requiring you to reconfigure credentials or re-authenticate every time you need to access a different account's Gmail or Drive resources.

Core Features & Use Cases

  • Alias-Based Account Switching: Quickly switch between pre-defined named accounts (work, personal, columbia) with a single command, no manual credential file management needed.
  • Credential Validation: Automatically checks if the selected account's credentials are saved, and guides you through the initialization process if they are missing.
  • Direct Service Commands: Run Gmail and Drive read operations directly against the selected account without manually setting environment variables or modifying gws configuration.
  • Use Case: If you regularly toggle between your work Gmail for urgent message triage and your personal Drive for file retrieval, this Skill removes all friction from switching contexts between accounts.

Quick Start

Use the gws-account-switch skill to switch to your work Google Workspace account and list the 5 most recent non-trashed files in your Drive.

Frequently Asked Questions about gws-account-switch

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I switch Google Workspace accounts for gws CLI commands?▼

The gws-account-switch skill automates switching between multiple Google Workspace accounts by selecting the correct pre-saved credential file and configuring the required environment variable for the gws CLI.

How do I manage multiple Google Workspace credentials for Gmail and Drive?▼

You can manage multiple Google Workspace credentials by pre-saving them as named aliases like work or personal, allowing the skill to validate their existence and guide initialization if missing before running Gmail or Drive operations.

Can I run Gmail and Drive operations directly against a specific Google Workspace account?▼

Yes, you can run Gmail and Drive read operations directly against a selected account without manually setting environment variables, as the skill configures the gws CLI environment automatically based on your chosen account alias.

Does gws CLI require manual environment variable configuration when accessing different accounts?▼

No, the skill removes the need for manual environment variable configuration when running gws commands against a specified target account by instantly applying the correct environment setup based on your selected named alias.

What happens if the Google Workspace credentials for my selected account are missing?▼

If the selected Google Workspace account credentials are missing, the skill automatically checks for them and guides you through the initialization process to ensure your credential management workflow continues without interruption.

What is the best way to toggle between work and personal Google Workspace accounts?▼

The best way to toggle between work and personal Google Workspace accounts is using alias-based switching, which instantly configures the correct credential file and environment variable to remove the friction of re-authenticating when switching contexts.

Related Skills

Explore More Software Engineering Skills→
ma08ma08
28

gws-drive

List, search, inspect, download, and export Google Drive files across saved accounts.

Community
Intermediate
DaddyElonMusk69DaddyElonMusk69

google-workspace

Provide unified CLI access to Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Community
Advanced
cellarwoodcellarwood

recipe-email-drive-link

Locate a Google Drive file, grant reader access, and email its link.

Official
Basic
Open-CuriosityOpen-Curiosity
1.7k

google-account-login

Automate Google account OAuth login and register it with the Gini system.

Official
Intermediate