Skip to content

docs(gmail): Add search tips and gotchas #62

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
omriariav wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(gmail): Add search tips and gotchas #62

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 4 additions & 1 deletion skills/gmail/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gws-gmail
version: 1.0.0
version: 1.1.0
description: "Google Gmail CLI operations via gws. Use when users need to list emails, read messages, send email, manage labels, archive, or trash messages. Triggers: gmail, email, inbox, send email, mail, labels, archive, trash."
metadata:
short-description: Google Gmail CLI operations
Expand Down Expand Up @@ -165,6 +165,9 @@ gws gmail list --format text # Human-readable text

## Tips for AI Agents

- `list` returns the latest `message_id` per thread — reading it may show someone else's reply. To find a specific person's message, use `gws gmail thread <thread-id>` and scan all messages
- When searching for emails involving a person, use the bare email as a search term (`from:me user@domain.com`) rather than `to:user@domain.com` — the `to:` operator only matches the To header, not CC recipients
- If using employee lookup tools to get someone's email, use the exact returned address — don't guess the format (e.g., `lior.g@` not `lior.golan@`)
- Always use `--format json` (the default) for programmatic parsing
- Use `gws gmail list` to get IDs: `message_id` for `read`/`label`/`archive`/`trash`, `thread_id` for `thread`
- Use `gws gmail thread <thread-id>` to view full conversations with all messages
Expand Down