tbroadley/gws-gmail
claude/skills/gws-gmail/SKILL.md
Read and search Gmail emails. Check inbox, search messages, and view email threads.
testing
Updated Apr 15, 2026
$ install --global
skillsauthnpx skillsauth add tbroadley/dotfiles gws-gmailInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 15, 2026, 2:12 AM26.7s1 file scanned
SKILL.md
- name:
- gws-gmail
- description:
- Read and search Gmail emails. Check inbox, search messages, and view email threads.
Gmail via gws CLI
See
../gws-shared/SKILL.mdfor auth, global flags, and CLI syntax.
gws gmail <resource> <method> [flags]
Quick Commands
Unread inbox summary
gws gmail +triage
gws gmail +triage --max 5 --query 'from:boss'
gws gmail +triage --format json | jq '.[].subject'
List messages
gws gmail users messages list --params '{"userId":"me","maxResults":10}'
gws gmail users messages list --params '{"userId":"me","q":"is:unread","maxResults":20}'
Read a message
gws gmail users messages get --params '{"userId":"me","id":"MESSAGE_ID","format":"full"}'
gws gmail users messages get --params '{"userId":"me","id":"MESSAGE_ID","format":"metadata"}'
Get a thread
gws gmail users threads get --params '{"userId":"me","id":"THREAD_ID","format":"full"}'
Labels
gws gmail users labels list --params '{"userId":"me"}'
Profile
gws gmail users getProfile --params '{"userId":"me"}'
Gmail Search Query Syntax
Use the q parameter with Gmail search syntax:
| Query | Description |
|-------|-------------|
| is:unread | Unread messages |
| is:starred | Starred messages |
| from:[email protected] | From specific sender |
| to:[email protected] | To specific recipient |
| subject:hello | Subject contains "hello" |
| has:attachment | Has attachments |
| filename:pdf | Has PDF attachment |
| after:2024/01/01 | After date |
| before:2024/01/31 | Before date |
| newer_than:7d | Last 7 days |
| older_than:1m | Older than 1 month |
| label:work | Has label |
| in:inbox | In inbox |
| in:sent | In sent |
Combine queries: from:[email protected] subject:urgent after:2024/01/01
API Resources
users.getProfile,users.stop,users.watchusers.drafts— CRUD on draftsusers.history— Mailbox change historyusers.labels— Label managementusers.messages— List, get, send, modify, trash, deleteusers.settings— Filters, forwarding, IMAP/POP, etc.users.threads— Thread operations
Notes
- The
+triagehelper is read-only and never modifies your mailbox - Message format options:
minimal,metadata,raw,full - The
snippetfield gives a preview without needing to decode the body - Thread IDs group related messages together
Related Skills
tbroadley/wispr-dictionary
tools
VerifiedTrustedCommunity
Add words to the Wispr Flow dictionary. Use when the user wants to add a word, phrase, or snippet to Wispr Flow for voice dictation.
SKILL.mdUpdated Apr 15, 2026
tbroadley/upload-pr-images
documentation
VerifiedTrustedCommunity
Upload images to a GitHub PR description or comment using a shared gist as image hosting. Use when the user wants to add plots, screenshots, or other images to a PR.
SKILL.mdUpdated Apr 15, 2026
tbroadley/todoist
testing
VerifiedTrustedCommunity
Manage tasks, projects, and productivity in Todoist. View tasks, add new items, check completed work, and organize projects.
SKILL.mdUpdated Apr 15, 2026
tbroadley/rebase-stack
data-ai
VerifiedTrustedCommunity
Use when working with stacked diffs (branch B based on branch A, which is based on main).
SKILL.mdUpdated Apr 15, 2026