gmail
Read and search Gmail messages. Use when user wants to check email, search inbox, or read messages.
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Gmail Integration
Connect to Gmail via IMAP to read, search, and browse emails.
Commands
All commands use the script: ~/.claude/skills/gmail/gmail
Profile & Folders
| Command | Description |
|---|---|
me |
Get account info (email, message counts) |
labels |
List all folders/labels |
Messages
| Command | Description |
|---|---|
list [flags] |
List messages from inbox |
get <messageId> |
Read full message content |
search <query> [flags] |
Search messages |
List Flags
| Flag | Description |
|---|---|
--label <folder> |
Folder name (INBOX, [Gmail]/Sent Mail, etc) |
--limit <n> |
Max results (default: 10) |
--unread |
Only unread messages |
Search Flags
| Flag | Description |
|---|---|
--limit <n> |
Max results (default: 10) |
--oldest |
Show oldest messages first (default: newest first) |
--all |
Search in All Mail (includes archived emails) |
--trash |
Search in Trash |
--label <folder> |
Search in specific folder |
Usage Examples
Check inbox
~/.claude/skills/gmail/gmail list --limit 5
Check unread messages
~/.claude/skills/gmail/gmail list --unread
Read a specific email
~/.claude/skills/gmail/gmail get 12345
Search for emails from someone
~/.claude/skills/gmail/gmail search "from:boss@company.com"
Search by subject
~/.claude/skills/gmail/gmail search "subject:invoice"
Search unread
~/.claude/skills/gmail/gmail search "is:unread"
Search old emails (oldest first)
~/.claude/skills/gmail/gmail search older_than:1y --oldest --limit 20
Search including archived emails
~/.claude/skills/gmail/gmail search "from:boss@company.com" --all
Search by date range
~/.claude/skills/gmail/gmail search "from:client@company.com before:2023/06/01"
List all folders
~/.claude/skills/gmail/gmail labels
Search Syntax
| Query | Description |
|---|---|
from:email@example.com |
From specific sender |
to:email@example.com |
To specific recipient |
subject:meeting |
Subject contains word |
is:unread |
Unread messages |
is:starred |
Starred messages |
before:2024/01/15 |
Before date (YYYY/MM/DD or YYYY-MM-DD) |
after:2024/01/15 |
After date |
older_than:7d |
Older than N days/months/years (d/m/y) |
newer_than:1m |
Newer than N days/months/years |
<text> |
Search in body |
Multiple terms can be combined: from:boss@company.com older_than:6m
When to Use
Activate this skill when user:
- Asks to check their email or inbox
- Wants to search for specific emails
- Needs to read an email's content
- Asks about unread messages
- Wants to find emails from someone
- Needs to browse their email folders
Notes
- This skill is read-only (no sending, deleting, or modifying emails)
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!