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

Score

Total Score

50/100

Based on repository quality metrics

✓SKILL.md

SKILL.mdファイルが含まれている

+20

○LICENSE

ライセンスが設定されている

0/10

○説明文

100文字以上の説明がある

0/10

○人気

GitHub Stars 100以上

0/15

○最近の活動

3ヶ月以内に更新がある

0/10

○フォーク

10回以上フォークされている

0/5

✓Issue管理

オープンIssueが50未満

+5

✓言語

プログラミング言語が設定されている

+5

○タグ

1つ以上のタグが設定されている

0/5

Reviews

💬

Reviews coming soon