How do I authenticate my Gmail account for this skill?

Authentication is handled via OAuth2. You can run 'gws auth login' to open a browser for consent and 'gws auth status' to verify your connection.

Is this an official Google plugin?

No, this skill utilizes the gws CLI, which is an independent, unofficial open-source project not endorsed by or affiliated with Google.

What output formats are available for automation?

The skill defaults to structured JSON, making it easy for AI agents or scripts to parse, but it also supports YAML and human-readable text formats.

Can I read entire conversations or just single messages?

Both. Use 'gws gmail read' for specific messages and 'gws gmail thread' to view the entire conversation history including headers and labels.

Does the skill support standard Gmail search operators?

Yes, you can use standard operators such as 'is:unread', 'from:', 'has:attachment', and 'label:' within the query flag of the list command.

Google Gmail CLI Operations

Name: Google Gmail CLI Operations
Author: omriariav

byomriariav

•

Productivity & Workflow

Manages Gmail messages, threads, and labels directly from the command line with structured JSON output and advanced search capabilities.

The gws-gmail skill provides a powerful CLI interface for managing Google Gmail accounts within the Claude Code environment. By utilizing the unofficial gws workspace tool, it enables developers to list, read, send, and reply to emails without leaving their terminal. It supports sophisticated Gmail search queries, full conversation thread management, and granular label control. This skill is ideal for automating email-based workflows, triaging inboxes, and even extracting calendar event IDs from invitation emails, all while providing machine-readable JSON for further programmatic processing.

Key Features

01Full conversation thread viewing and bulk thread archiving to maintain inbox zero.

022 GitHub stars

03Dynamic label management for adding, removing, and listing system and custom labels.

04Calendar event ID extraction from invite emails for integration with scheduling tasks.

05Complete email lifecycle management including listing, reading, sending, replying, and trashing.

06Advanced search support using standard Gmail query syntax like 'is:unread' and 'from:user'.

Use Cases

01Bulk organizing and labeling emails using CLI commands for faster inbox triage.

02Automating routine email replies or notifications as part of a development or deployment pipeline.

03Searching and retrieving technical details or credentials from an inbox while staying in the coding workflow.

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add omriariav/workspace-cli gmail

For use in Claude.ai and ChatGPT