← Back to Skills Marketplace
Gws Gmail Watch
by
googleworkspace-bot
· GitHub ↗
· v1.0.12
· MIT-0
535
Downloads
0
Stars
16
Active Installs
13
Versions
Install in OpenClaw
/install gws-gmail-watch
Description
Gmail: Watch for new emails and stream them as NDJSON.
README (SKILL.md)
gmail +watch
PREREQUISITE: Read
../gws-shared/SKILL.mdfor auth, global flags, and security rules. If missing, rungws generate-skillsto create it.
Watch for new emails and stream them as NDJSON
Usage
gws gmail +watch
Flags
| Flag | Required | Default | Description |
|---|---|---|---|
--project |
— | — | GCP project ID for Pub/Sub resources |
--subscription |
— | — | Existing Pub/Sub subscription name (skip setup) |
--topic |
— | — | Existing Pub/Sub topic with Gmail push permission already granted |
--label-ids |
— | — | Comma-separated Gmail label IDs to filter (e.g., INBOX,UNREAD) |
--max-messages |
— | 10 | Max messages per pull batch |
--poll-interval |
— | 5 | Seconds between pulls |
--msg-format |
— | full | Gmail message format: full, metadata, minimal, raw |
--once |
— | — | Pull once and exit |
--cleanup |
— | — | Delete created Pub/Sub resources on exit |
--output-dir |
— | — | Write each message to a separate JSON file in this directory |
Examples
gws gmail +watch --project my-gcp-project
gws gmail +watch --project my-project --label-ids INBOX --once
gws gmail +watch --subscription projects/p/subscriptions/my-sub
gws gmail +watch --project my-project --cleanup --output-dir ./emails
Tips
- Gmail watch expires after 7 days — re-run to renew.
- Without --cleanup, Pub/Sub resources persist for reconnection.
- Press Ctrl-C to stop gracefully.
See Also
- gws-shared — Global flags and auth
- gws-gmail — All send, read, and manage email commands
Usage Guidance
This skill appears to just wrap a 'gws' CLI command to watch Gmail, but it hides its authentication steps in a referenced ../gws-shared/SKILL.md that is not included. Before installing or running it: 1) inspect the referenced gws-shared SKILL.md to see exactly how auth is performed and where credentials/config are stored; 2) verify the provenance and integrity of the 'gws' binary (where it comes from and what permissions it requires); 3) confirm what Google/GCP credentials or service account scopes are needed (Gmail API, Pub/Sub publisher/subscriber) and grant only least privilege; 4) be cautious about Pub/Sub resources left behind — prefer using --cleanup or a disposable project/account for testing; 5) if you cannot review the shared auth file or trust the gws binary source, do not install or run this skill.
Capability Analysis
Type: OpenClaw Skill
Name: gws-gmail-watch
Version: 1.0.12
The skill bundle provides documentation for a Gmail monitoring tool using the 'gws' CLI and Google Cloud Pub/Sub. The functionality described in SKILL.md is consistent with its stated purpose of watching for new emails and streaming them as NDJSON, and it contains no evidence of malicious intent, hidden commands, or prompt injection.
Capability Assessment
Purpose & Capability
The skill is instruction-only and simply invokes the 'gws' CLI to watch Gmail and stream NDJSON, which aligns with the name/description. Requiring the 'gws' binary is expected for this purpose.
Instruction Scope
SKILL.md explicitly directs the agent to read ../gws-shared/SKILL.md for auth, global flags, and security rules. That external file likely contains authentication steps and possibly references to credentials or config paths — a hidden dependency not included here. The instructions also create/use GCP Pub/Sub resources (topic/subscription) which imply access to GCP IAM and Gmail push configuration even though those details are not surfaced.
Install Mechanism
There is no install spec and no code files — lowest-risk delivery model. The only runtime requirement is that a 'gws' binary exists on PATH; the skill does not itself download or execute additional artifacts.
Credentials
The skill operates on Gmail and GCP Pub/Sub but declares no required environment variables or primary credential. Because it references another SKILL.md for auth, required credentials (Google OAuth tokens, service account keys, GCP project credentials) are hidden rather than declared, which is disproportionate and opaque.
Persistence & Privilege
The skill is not always-enabled and does not request persistent presence or elevated platform privileges. It does have options to create persistent GCP Pub/Sub resources, but that behavior is controlled by flags (e.g., --cleanup) and is within the user's control.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install gws-gmail-watch - After installation, invoke the skill by name or use
/gws-gmail-watch - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.12
- Bumped skill version from 0.22.4 to 0.22.5 in SKILL.md.
- No other changes were made.
v1.0.11
- Bumped metadata version from 0.22.3 to 0.22.4 in SKILL.md.
- No other functional or usage changes.
v1.0.10
- Updated version in SKILL.md metadata from 0.22.2 to 0.22.3.
- No functional or usage changes; documentation version only.
v1.0.9
- Updated version in SKILL.md metadata to 0.22.2.
- No functional or documentation changes beyond the version bump.
v1.0.8
- Bumped metadata version from 0.22.0 to 0.22.1 in SKILL.md.
- No functional or usage changes.
- Documentation only update.
v1.0.7
- Bumped version from 0.21.2 to 0.22.0 in SKILL.md.
- No changes to usage, flags, examples, or functionality documented.
- No other file modifications indicated.
v1.0.6
- Updated internal version from 0.21.1 to 0.21.2 in SKILL.md.
- No changes to usage, features, commands, or documentation content.
v1.0.5
- Bumped skill version from 0.20.1 to 0.21.1 in SKILL.md.
v1.0.4
- Updated skill version metadata from 0.20.0 to 0.20.1 in SKILL.md.
v1.0.3
- Version updated from 0.19.0 to 0.20.0 in SKILL.md.
- No functional or documentation changes other than the version bump.
v1.0.2
- Metadata version key updated to 0.19.0; top-level version field removed.
- No functional changes to usage, interface, or documentation content.
- Minor internal metadata structure update for compatibility.
v1.0.1
- No functional changes; only SKILL.md formatting was updated.
- List formatting for the required binaries improved for consistency.
- No user-facing or CLI changes.
v1.0.0
Initial release of gws-gmail-watch.
- Adds a command to watch for new Gmail emails and stream them as NDJSON.
- Supports filtering by label, configuring message batch size, polling interval, message format, and output directory.
- Integrates with Google Pub/Sub for event delivery; can manage or reuse Pub/Sub resources.
- Includes options for one-off pulls, resource cleanup, and output file generation.
- Detailed flag descriptions, usage examples, and tips provided in documentation.
- Requires gws CLI and gws-shared SKILL for authentication and common flags.
Metadata
Frequently Asked Questions
What is Gws Gmail Watch?
Gmail: Watch for new emails and stream them as NDJSON. It is an AI Agent Skill for Claude Code / OpenClaw, with 535 downloads so far.
How do I install Gws Gmail Watch?
Run "/install gws-gmail-watch" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Gws Gmail Watch free?
Yes, Gws Gmail Watch is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Gws Gmail Watch support?
Gws Gmail Watch is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Gws Gmail Watch?
It is built and maintained by googleworkspace-bot (@googleworkspace-bot); the current version is v1.0.12.
More Skills