gws-auth

Manage OAuth 2.0 authentication for Google Workspace services via the gws CLI.

7|2|Updated Jan 22, 2026
One-click install
npx skills add https://github.com/omriariav/workspace-cli --skill gws-auth
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-auth
Source: https://github.com/omriariav/workspace-cli/tree/main/skills/auth
Command: npx skills add https://github.com/omriariav/workspace-cli --skill gws-auth

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill simplifies the complex process of setting up and managing authentication for Google Workspace applications, ensuring secure and seamless access to your Google services.

Core Features & Use Cases

  • OAuth 2.0 Authentication: Handles the entire OAuth 2.0 flow for Google APIs.
  • Credential Management: Securely stores and refreshes authentication tokens.
  • Use Case: When a new user needs to use the gws CLI to interact with their Gmail and Calendar, this Skill guides them through the authentication process, obtaining the necessary permissions.

Quick Start

Guide the user through the process of logging into Google Workspace using their credentials.

Frequently Asked Questions about gws-auth

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

FAQPage Schema
How do I authenticate the gws CLI with Google Workspace services?

This Skill manages OAuth 2.0 authentication for Google Workspace by handling client ID and client secret inputs, then obtaining and storing the necessary access tokens for the gws CLI to interact with your Google services.

How does token refresh work for Google Workspace CLI credentials?

Token refresh is handled automatically by this Skill, which securely stores your OAuth 2.0 tokens and refreshes them as needed to maintain continuous, compliant access to Google Workspace APIs via the CLI.

Can I limit CLI access to specific Google Workspace services like Gmail and Drive?

Yes, you can limit CLI access by using scoped authorization. This Skill supports defining specific permission scopes for services like Gmail, Calendar, and Drive, ensuring your CLI operations comply with security best practices.

What do I need to set up OAuth 2.0 for Google Workspace CLI access?

You need a client ID and client secret from your Google Cloud project. This Skill uses these credentials to facilitate the secure OAuth 2.0 authentication flow and obtain the required service permissions for the gws CLI.

Why do I need scoped authorization for Google Workspace APIs?

Scoped authorization is needed to ensure compliance with security best practices. It limits access to only the specific services and data required, such as Gmail or Drive, rather than granting unrestricted access to your entire Google Workspace account.