Read-only Gmail access through the authenticated Chrome tab via surf. Find the Gmail tab, snapshot inbox rows, open and read a thread by keyword. Use when the user says "check my email", "read the inbox", "did a verification code arrive", "find the bounce message", or when a workflow needs email as an inbound channel (codes, bounces, replies). Outbound mail is out of scope — drafts belong to mailbox-mining.
Installs into .claude/skills of the current project.
Are you the author of Gmail?
Add the live security badge to your README. It updates with every re-scan.
[](https://www.skillsdirectory.com/skills/grahama1970-gmail)
---
name: gmail
description: >
Read-only Gmail access through the authenticated Chrome tab via surf.
Find the Gmail tab, snapshot inbox rows, open and read a thread by
keyword. Use when the user says "check my email", "read the inbox",
"did a verification code arrive", "find the bounce message", or when a
workflow needs email as an inbound channel (codes, bounces, replies).
Outbound mail is out of scope — drafts belong to mailbox-mining.
triggers:
- check my email
- read the inbox
- did the code email arrive
- find the bounce message
- gmail verification code
provides:
- mailbox-read
composes:
- surf
- agentic-evals
complies:
- best-practices-skills
- best-practices-python
taxonomy:
- precision
---
# gmail
Read-only Gmail through the already-authenticated Chrome tab. Closes the
`composes: [gmail]` edge mailbox-mining has declared.
## Commands
```bash
./run.sh tabs # Gmail tab id
./run.sh inbox --limit 10 # row snapshot (from/subject/time)
./run.sh read --keyword godaddy # open newest matching thread, extract body
```
## Boundaries
- READ-ONLY. No compose, no send, no label changes.
- Requires a Gmail tab open in Chrome (surf transport).
- Bodies are truncated to 3000 chars — enough for codes/bounces, not for archives.
## Failure posture
Typed JSON exits: `gmail_tab_not_found` (2, fix: open Gmail), `thread_not_found`
(3), transport error (1). Never a bare failure.
