# Google Gmail

> Read, send, search, and manage Gmail messages. Use when the user asks about email, inbox, or wants to send/reply to messages.

- Skill: `rotoslider/google-gmail` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add rotoslider/google-gmail`
- Raw SKILL.md: https://api.skillmd.com/api/skills/rotoslider/google-gmail/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: rotoslider (https://skillmd.com/u/rotoslider)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/rotoslider/google-gmail

---


# Google Gmail

## When to Use
- Check inbox -> `list_emails`
- Read specific email -> `read_email` (needs message_id from list/search)
- Draft/compose/write an email -> `draft_email` (saves to Drafts, does NOT send)
- Send email immediately -> `send_email` (only when user explicitly says "send")
- Search emails -> `search_emails` (Gmail search syntax: from:, subject:, is:unread, etc.)
- Archive email -> `archive_email` (removes from inbox)
- Reply to email -> `reply_to_email` (preserves thread)

## Important
- **ALWAYS prefer draft_email over send_email** unless the user explicitly says "send"
- "draft", "compose", "write", "prepare" an email -> use `draft_email`
- "send" an email -> use `send_email`
- Message IDs come from list_emails or search_emails results
- Gmail search syntax: from:user@example.com, subject:meeting, is:unread, has:attachment, newer_than:2d