Sytex

gmail

1
0
# Install this skill:
npx skills add Sytex/agent-skills --skill "gmail"

Install specific skill from multi-skill repository

# Description

Read and search Gmail messages. Use when user wants to check email, search inbox, or read messages.

# SKILL.md


name: gmail
description: Read and search Gmail messages. Use when user wants to check email, search inbox, or read messages.
allowed-tools: Read, Bash(~/.claude/skills/gmail/:)


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:[email protected]"

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:[email protected]" --all

Search by date range

~/.claude/skills/gmail/gmail search "from:[email protected] before:2023/06/01"

List all folders

~/.claude/skills/gmail/gmail labels

Search Syntax

Query Description
from:[email protected] From specific sender
to:[email protected] 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:[email protected] 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)

# Supported AI Coding Agents

This skill is compatible with the SKILL.md standard and works with all major AI coding agents:

Learn more about the SKILL.md standard and how to use these skills with your preferred AI coding agent.