gmail

by @Sytex in AI & LLM

# 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:

⚡ Amp 🚀 Antigravity 🤖 Claude Code 🦀 Clawdbot 📝 Codex ▶️ Cursor 🤖 Droid 💎 Gemini CLI 🐙 GitHub Copilot 🪿 Goose 📊 Kilo Code 🔧 Kiro CLI 💻 OpenCode 🦘 Roo Code 🌲 Trae 🏄 Windsurf

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