# Email

> Gmail management using gmcli. Use when user wants to check, search, read, send, or manage emails.

- Skill: `thrownlemon/email` (Agent Skill)
- Install (CLI): `npx skillmds@latest add thrownlemon/email`
- Raw SKILL.md: https://api.skillmd.com/api/skills/thrownlemon/email/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: ThrownLemon (https://skillmd.com/u/thrownlemon)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/thrownlemon/email

---


# Gmail Email Management

When the user wants to manage their email from the terminal, delegate to the `gmail-assistant` subagent.

## When to Use

Use this skill when the user:
- Asks to check their email or inbox
- Wants to search for specific emails
- Needs to read an email thread
- Wants to send or compose an email
- Mentions Gmail or email management
- Asks about unread messages

## What the Subagent Handles

The `gmail-assistant` subagent uses gmcli to:

1. **Search Emails**
   - Use Gmail query syntax
   - Return formatted results
   - Offer to read specific threads


2. **Read Threads**
   - Display full conversation
   - Show attachments
   - Offer follow-up actions

3. **Send Emails**
   - Compose with to/cc/bcc
   - Support attachments
   - Confirm before sending

4. **Manage Drafts**
   - Create, edit, delete drafts
   - Send saved drafts

5. **Handle Labels**
   - List available labels
   - Add/remove labels from threads
   - Archive messages

## Default Behaviors

- **"Check my email"** - Search for unread emails: `is:unread newer_than:1d`
- **"Any new emails?"** - Same as above
- **"Check inbox"** - Show recent inbox: `in:inbox newer_than:1d`
- **"Email from X"** - Search: `from:X`

## Setup Required

If gmcli is not installed or configured, the subagent will guide the user through setup:
1. Install via npm
2. Configure Google OAuth credentials
3. Add Gmail account

## Example Triggers

- "Check if I have any new emails"
- "Search for emails from John about the project"
- "Send an email to alice@example.com"
- "Read that email thread"
- "Check my inbox for unread messages"
- "Any emails from my boss today?"