add-gws

Integrate Google Workspace CLI with OAuth and MCP server registration.

Updated Mar 4, 2026
One-click install
npx skills add https://github.com/alanmun/vivian --skill add-gws
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: add-gws
Source: https://github.com/alanmun/vivian/tree/main/.agents/skills/add-gws
Command: npx skills add https://github.com/alanmun/vivian --skill add-gws

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) and assets (resource) components.

What problem does it solve?

This Skill streamlines the integration of Google Workspace tools (Gmail, Calendar, Drive) into your agent's workflow, enabling it to interact with your Google services directly.

Core Features & Use Cases

  • Google Workspace CLI Installation: Installs the necessary tools within the agent's environment.
  • OAuth Profile Support: Configures secure authentication for accessing Google services.
  • MCP Server Registration: Makes Gmail, Calendar, and Drive accessible as services to the agent.
  • Use Case: Enable your AI assistant to draft emails in Gmail, schedule meetings in Calendar, or find files in Drive by simply asking it to perform these actions.

Quick Start

Apply the add-gws skill to your agent's configuration.

Frequently Asked Questions about add-gws

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

FAQPage Schema
How do I integrate Google Workspace services like Gmail and Calendar with my AI agent?

This skill integrates Google Workspace by registering a gws MCP server within your agent's environment, enabling direct access to Gmail, Calendar, and Drive services.

How do I configure OAuth for Google Workspace CLI access in an agent environment?

OAuth profile configuration requires executing the `gws auth login` command on your host machine, establishing secure authentication for the agent to access your Google services.

Do I need to install the @googleworkspace/cli package before using Gmail or Calendar with my agent?

Yes, installing the `@googleworkspace/cli` package is a required dependency before this skill can configure the MCP server and enable agent-based access to Google Workspace.

What is an MCP server used for in Google Workspace integration?

An MCP server acts as the protocol bridge in your agent's environment, exposing Gmail, Calendar, and Drive commands from the gws CLI as accessible services to the AI assistant.

Can my AI assistant draft emails and schedule meetings using the gws MCP server?

Yes, once the gws MCP server is registered, your AI assistant can directly draft emails in Gmail, schedule meetings in Calendar, and find files in Drive by executing CLI commands.

Why does my Google Workspace agent integration fail to authenticate?

Authentication fails if the host-side `gws auth login` command was not executed prior to configuration, preventing the OAuth profile from establishing a valid Google Workspace session.