skills.rest
redlanternstudios
redlanternstudiosCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

google-workspace

Automates Google Workspace tasks via the gws CLI for Drive, Docs, Sheets, Gmail, Calendar, and Chat.

Updated Jun 15, 2026
Search Tags:#gmail#calendar#google workspace#google sheets#google drive#api automation#gws cli
One-click install
npx skills add https://github.com/redlanternstudios/swarmclaw --skill google-workspace-redlanternstudios
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: google-workspace
Source: https://github.com/redlanternstudios/swarmclaw/tree/main/skills/google-workspace
Command: npx skills add https://github.com/redlanternstudios/swarmclaw --skill google-workspace-redlanternstudios

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Working with Google Workspace APIs normally requires writing custom HTTP calls, handling OAuth flows, and parsing raw REST responses. This Skill lets an agent operate Drive, Docs, Sheets, Gmail, Calendar, and Chat through the gws CLI, which already knows the Workspace API surface and returns structured JSON by default. ## Core Features & Use Cases - Unified Workspace CLI access: Run read, list, get, and mutation commands across Drive, Docs, Sheets, Gmail, Calendar, and Chat from one tool. - Structured JSON output: Commands return machine-readable JSON, with params, jsonInput, pageAll, and dryRun options for controlled execution. - Safe operation rules: Enforces read-before-write workflows, ID confirmation before mutations, and no interactive auth from agent tool calls. - Use Case: Ask the agent to list your 10 most recent unread Gmail messages, fetch a Google Doc's content for summarization, or pull upcoming events from your primary calendar. ## Quick Start Use the google-workspace skill to list my 10 most recent files in Google Drive and show their names and IDs.

Frequently Asked Questions about google-workspace

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

FAQPage Schema
How do I list Google Drive files from the command line?▼

Use the gws CLI with `gws drive files list --params '{"pageSize":10}'` to list Drive files as structured JSON. You can then pass a file ID to `gws drive files get --file-id <FILE_ID>` to retrieve a specific file's metadata.

How to read Gmail messages using a CLI tool?▼

The gws CLI reads Gmail via `gws gmail users messages list --user-id me --params '{"maxResults":10}'` to list messages, then `gws gmail users messages get --user-id me --message-id <MESSAGE_ID>` to fetch a specific message.

Does the gws CLI support Google Sheets and Google Docs?▼

Yes, gws supports both. Use `gws docs get --document-id <DOC_ID>` for Google Docs and `gws sheets spreadsheets get --spreadsheet-id <SPREADSHEET_ID>` for Sheets, both returning structured JSON responses.

Why does gws fail with authentication errors in an agent tool call?▼

gws cannot run interactive auth flows from an agent tool call. You must configure authentication in the plugin settings or log in manually from a terminal first, then the agent can reuse that authenticated session.

What should I do before mutating Google Workspace resources with gws?▼

Always run read, list, or get commands first to confirm the correct document, file, message, or calendar IDs. For risky mutations, use the `dryRun: true` option in the tool call to preview the operation before executing it.

Related Skills

Explore More Software Engineering Skills→
googleworkspacegoogleworkspace
30.3k

gws-shared

Document shared gws CLI patterns for authentication, flags, and output formatting.

Official
Intermediate
jlui17jlui17

gog

Operate Google Docs, Drive, Sheets, Calendar, and Gmail through the gog CLI.

Community
Intermediate
AissenLiuAissenLiu

google-workspace

Automate Gmail, Calendar, Drive, Contacts, Sheets, and Docs tasks via Hermes-managed OAuth.

Community
Advanced
evolving-machines-labevolving-machines-lab
76

evolve-dev

Build and run AI agents in secure sandboxes with TypeScript and Python SDKs.

Official
Advanced