Agent skill

Gmail

by team-attention in team-attention/plugins-for-claude-natives

This skill should be used when the user asks to "check email", "read emails", "send email", "reply to email", "search inbox", or manages Gmail.

MITAuto-check passedProductivity & Automation

Install Gmail

skills CLI

$ npx skills add team-attention/plugins-for-claude-natives --skill gmail -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI

$ gh skill install team-attention/plugins-for-claude-natives gmail --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy

$ git clone --depth 1 https://github.com/team-attention/plugins-for-claude-natives.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/gmail/skills/gmail .claude/skills/gmail && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Paste into Claude Code

Install the "gmail" agent skill from https://github.com/team-attention/plugins-for-claude-natives/tree/main/plugins/gmail/skills/gmail into .claude/skills/gmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/team-attention/plugins-for-claude-natives/tree/main/plugins/gmail/skills/gmail

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add team-attention/plugins-for-claude-natives --skill gmail -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install team-attention/plugins-for-claude-natives gmail --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/team-attention/plugins-for-claude-natives.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/gmail/skills/gmail .agents/skills/gmail && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "gmail" agent skill from https://github.com/team-attention/plugins-for-claude-natives/tree/main/plugins/gmail/skills/gmail into .agents/skills/gmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add team-attention/plugins-for-claude-natives --skill gmail -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install team-attention/plugins-for-claude-natives gmail --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/team-attention/plugins-for-claude-natives.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/gmail/skills/gmail .cursor/skills/gmail && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "gmail" agent skill from https://github.com/team-attention/plugins-for-claude-natives/tree/main/plugins/gmail/skills/gmail into .cursor/skills/gmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/team-attention/plugins-for-claude-natives.git --path plugins/gmail/skills/gmail

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add team-attention/plugins-for-claude-natives --skill gmail -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install team-attention/plugins-for-claude-natives gmail --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/team-attention/plugins-for-claude-natives.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/gmail/skills/gmail .gemini/skills/gmail && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "gmail" agent skill from https://github.com/team-attention/plugins-for-claude-natives/tree/main/plugins/gmail/skills/gmail into .gemini/skills/gmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install team-attention/plugins-for-claude-natives gmail

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add team-attention/plugins-for-claude-natives --skill gmail -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/team-attention/plugins-for-claude-natives.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/gmail/skills/gmail .github/skills/gmail && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "gmail" agent skill from https://github.com/team-attention/plugins-for-claude-natives/tree/main/plugins/gmail/skills/gmail into .github/skills/gmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add team-attention/plugins-for-claude-natives --skill gmail -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install team-attention/plugins-for-claude-natives gmail --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/team-attention/plugins-for-claude-natives.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/gmail/skills/gmail .opencode/skills/gmail && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "gmail" agent skill from https://github.com/team-attention/plugins-for-claude-natives/tree/main/plugins/gmail/skills/gmail into .opencode/skills/gmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "gmail", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: gmail
GitHub stars: 825
Token cost: ~967 tokens
SKILL.md length: 206 words
Files: 21 (incl. scripts, references, assets)
Skills in repo: 16
Repo updated: Apr 20, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

This skill should be used when the user asks to "check email", "read emails", "send email", "reply to email", "search inbox", or manages Gmail.

Asks to check email
SKILL.md covers Account Setup, Email Sending Workflow (5 Steps), CLI Quick Reference and View Email in Web, plus 2 more sections
Runs Python scripts from its folder; calls uv; reaches mail.google.com
Tasks that involve Email management

What it does

Gmail is an agent skill from team-attention/plugins-for-claude-natives. This skill should be used when the user asks to "check email", "read emails", "send email", "reply to email", "search inbox", or manages Gmail. Supports multi-account Gmail integration for reading, searching, sending, and label management.

Its SKILL.md is about 970 tokens, which your agent loads only when the skill is triggered. The skill folder holds 24 other files, including scripts, reference files and assets (for example `assets/accounts.default.yaml`, `assets/email-templates.md` and `assets/signatures.md`).

It sits in Productivity & Automation, covering Email management. It works with Gmail. The repository describes itself as: Claude Code plugins for power users. The licence is MIT.

When your agent uses it

Asks to check email
Tasks that involve Email management

Example prompts

“check email”
“read emails”
“send email”
“/gmail”

Requirements

Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit fd9c207. It shows what the files ask for, not the result of running them.

Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Ships 7 files in scripts/ (Python, from the files we listed), which the agent can run.
Shell commands in SKILL.md call:
- uv
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
- mail.google.com
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gmail loads about 967 tokens when it runs, and up to ~3k if it reads all its reference files. Until then it costs about 61 tokens; SKILL.md has 206 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~61
When it runs · the whole SKILL.md, loaded when a task matches: ~967
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from team-attention/plugins-for-claude-natives at commit fd9c207, republished under its MIT licence (© team-attention). 206 words, ~967 tokens.

Download SKILL.mdSave it as .claude/skills/gmail/SKILL.md (or your agent's skills folder). This skill also uses 20 other files; get the full folder from GitHub.

name: gmail
description: This skill should be used when the user asks to "check email", "read emails", "send email", "reply to email", "search inbox", or manages Gmail. Supports multi-account Gmail integration for reading, searching, sending, and label management.

Gmail Skill

Manage emails through Gmail API - read, search, send, and organize across multiple Google accounts.

Account Setup

Before running any command, read accounts.yaml to check registered accounts.

If accounts.yaml is missing or empty → Read references/setup-guide.md for initial setup

yaml

# accounts.yaml example
accounts:
  personal:
    email: user@gmail.com
    description: Personal Gmail
  work:
    email: user@company.com
    description: Work account

Email Sending Workflow (5 Steps)

When sending emails, create 5 Tasks with TaskCreate and execute sequentially:

Step	Task	Key Action
1	Gather context	Run Explore SubAgents in parallel: recipient info, related projects, background context
2	Check previous conversations	Search `--query "to:recipient OR from:recipient newer_than:90d"` → AskUserQuestion for thread selection
3	Draft email	Compose draft → AskUserQuestion for feedback
4	Test send	Send `[TEST]` email to user's own address → Open in Gmail web → Request confirmation
5	Actual send	Send to recipient → Report completion

Signature: Append ---\nSent with Claude Code to all outgoing emails

Workflow Example: "Send a meeting email to John"

1. Create 5 Tasks
2. Step 1: Run parallel Explore SubAgents
   - Search recipient (John) info (partners/, projects/, context.md, etc.)
   - Search meeting context (calendar, recent meeting notes, etc.)
3. Step 2: Search "to:john@company.com OR from:john@company.com"
   → If previous conversation exists, AskUserQuestion (reply/new email)
4. Step 3: Draft email → AskUserQuestion (proceed/revise)
5. Step 4: Test send to my email → Open in Gmail web (`open "https://mail.google.com/mail/u/0/#inbox/{message_id}"`) → Request confirmation
6. Step 5: Actual send → Done

CLI Quick Reference

bash

# List messages
uv run python scripts/list_messages.py --account work --query "is:unread" --max 10

# Send email
uv run python scripts/send_message.py --account work --to "user@example.com" --subject "Subject" --body "Content"

# Check profile
uv run python scripts/manage_labels.py --account work profile

Detailed CLI usage: references/cli-usage.md Search query reference: references/search-queries.md

View Email in Web

After sending, use the returned Message ID to view directly in Gmail web:

bash

# URL format
https://mail.google.com/mail/u/0/#inbox/{message_id}

# Example: Open in browser after test send
open "https://mail.google.com/mail/u/0/#inbox/19c145bbd47ddd01"

Note: u/0 is the first logged-in account, u/1 is the second account

File Structure

skills/gmail/
├── SKILL.md
├── accounts.yaml           # Account metadata
├── scripts/                # CLI scripts
├── references/
│   ├── setup-guide.md      # Initial setup guide
│   ├── cli-usage.md        # Detailed CLI usage
│   ├── search-queries.md   # Search query reference
│   └── credentials.json    # OAuth Client ID (gitignore)
├── assets/
│   ├── accounts.default.yaml  # Account config template
│   ├── email-templates.md     # Email body templates
│   └── signatures.md          # Signature templates (Plain/HTML)
└── accounts/               # Per-account tokens (gitignore)

Error Handling

Situation	Resolution
accounts.yaml missing	Read `references/setup-guide.md` for initial setup
Token missing	Guide user to run `setup_auth.py --account <name>`
Token expired	Auto-refresh; if failed, guide re-authentication

Files

SKILL.md and 20 other files (scripts, references, assets) in plugins/gmail/skills/gmail of team-attention/plugins-for-claude-natives.

SKILL.md
.gitignore
accounts.yaml.example
assets/accounts.default.yaml
assets/email-templates.md
assets/signatures.md
pyproject.toml
references/cli-usage.md
references/search-queries.md
references/setup-guide.md
scripts/core/__init__.py
scripts/core/batch_processor.py
scripts/core/cache_manager.py
scripts/core/quota_manager.py
scripts/core/retry_handler.py
scripts/gmail_client.py
scripts/list_messages.py
… and 4 more

Open the folder on GitHubat commit fd9c207

Compare with similar skills

Gmail next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Gmail compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Gmail this skillteam-attention/plugins-for-claude-natives	825	—	~967	Automated safety check: Pass	MIT	5 mo ago
Career-Ops Gmail Lead Plugincareer-ops-hq/career-ops	74k	—	~233	Automated safety check: Notes	MIT	today
Connect Apps with ComposioComposioHQ/awesome-claude-skills	77k	3 repos	~557	Automated safety check: Pass	None	19 days ago
Gmail Emailopen-gitagent/gitagent	710	—	~235	Automated safety check: Notes	MIT	1 mo ago
Zeleremorses/zele	299	—	~1.3k	Automated safety check: Pass	None	6 days ago
Google Workspaceyc-software/qm	15k	—	~1.8k	Automated safety check: Pass	MIT	today

Similar skills

Career-Ops Gmail Lead Plugin
career-ops-hq/career-ops
Pulls job leads from a Gmail label into the career-ops pipeline, extracting job URLs from DMARC-passing emails and de-duplicating against existing leads.
74k GitHub stars~233 tokensUpdated today
Productivity & AutomationAuto-check: notes
Connect Apps with Composio
ComposioHQ/awesome-claude-skills
Connects an agent to 1000+ external apps through the Composio Tool Router plugin, so it can actually send emails, create issues and post messages instead of only drafting them.
77k GitHub starsUsed in 3 repos~557 tokens
Productivity & AutomationAuto-check passed
Gmail Email
open-gitagent/gitagent
Send emails via Gmail SMTP using App Password authentication.
710 GitHub stars~235 tokensUpdated 1 mo ago
Productivity & AutomationAuto-check: notes
Zele
remorses/zele
zele is a multi-account email and calendar CLI for Gmail, IMAP/SMTP (Fastmail, Outlook, any provider), and Google Calendar.
299 GitHub stars~1.3k tokensUpdated 6 days ago
Productivity & AutomationAuto-check passed
Google Workspace
yc-software/qm
Read and act on the user's Gmail, Google Calendar, and Google Tasks through per-user OAuth.
15k GitHub stars~1.8k tokensUpdated today
Productivity & AutomationAuto-check passed
Gmcli
badlogic/pi-skills
Gmail CLI for searching emails, reading threads, sending messages, managing drafts, and handling labels/attachments.
2.6k GitHub stars~470 tokensUpdated 4 mo ago
Productivity & AutomationAuto-check passed

More from team-attention/plugins-for-claude-natives

All 16 skills in this repo

History Insight
team-attention/plugins-for-claude-natives
This skill should be used when user wants to access, capture, or reference Claude Code session history.
825 GitHub stars~834 tokensUpdated 5 mo ago
Auto-check passed
Session Analyzer
team-attention/plugins-for-claude-natives
This skill should be used when the user asks to "analyze session", "세션 분석", "evaluate skill execution", "스킬 실행 검증", "check session logs", "로그 분석", provides a session ID with a skill path, or wants…
825 GitHub stars~1.8k tokensUpdated 5 mo ago
Auto-check passed
Tech Decision
team-attention/plugins-for-claude-natives
This skill should be used when the user asks to "기술 의사결정", "뭐 쓸지 고민", "A vs B", "비교 분석", "라이브러리 선택", "아키텍처 결정", "어떤 걸 써야 할지", "트레이드오프", "기술 선택", "구현 방식 고민", or needs deep analysis for technical…
825 GitHub starsUsed in 3 repos~1.2k tokens
Auto-check passed
Youtube Digest
team-attention/plugins-for-claude-natives
This skill should be used when the user asks to "유튜브 정리", "영상 요약", "transcript 번역", "YouTube digest", "영상 퀴즈", or provides a YouTube URL for analysis.
825 GitHub stars~557 tokensUpdated 5 mo ago
Auto-check passed
Fetch Tweet
team-attention/plugins-for-claude-natives
This skill should be used when the user asks to "트윗 가져와", "트윗 번역", "X 게시글 읽어줘", "tweet fetch", "트윗 내용", "트윗 원문", or provides an X/Twitter URL (x.com, twitter.com) and wants to read, translate, or…
825 GitHub stars~518 tokensUpdated 5 mo ago
Auto-check passed
Podcast
team-attention/plugins-for-claude-natives
Generate Korean podcast episodes from any source (URLs, tweets, articles, PDFs) — analyzes content, writes a script, generates audio via OpenAI TTS, converts to MP4, and auto-uploads to YouTube.
825 GitHub stars~1.5k tokensUpdated 5 mo ago
Auto-check passed

Works with

Gmail

Questions about Gmail

What does Gmail do?

This skill should be used when the user asks to "check email", "read emails", "send email", "reply to email", "search inbox", or manages Gmail. Gmail is an agent skill from team-attention/plugins-for-claude-natives. This skill should be used when the user asks to "check email", "read emails", "send email", "reply to email", "search inbox", or manages Gmail.

When should I use Gmail?

Gmail fits situations like: asks to check email; tasks that involve Email management.

How do I install Gmail in Claude Code?

Run `npx skills add team-attention/plugins-for-claude-natives --skill gmail -a claude-code`. Or copy the skill folder (plugins/gmail/skills/gmail in team-attention/plugins-for-claude-natives) into .claude/skills/gmail in your project. Claude Code loads it when a task matches its description.

How do I install Gmail in Codex?

Run `npx skills add team-attention/plugins-for-claude-natives --skill gmail -a codex`. Or copy the skill folder (plugins/gmail/skills/gmail in team-attention/plugins-for-claude-natives) into .agents/skills/gmail in your project. Codex loads it when a task matches its description.

Can I use Gmail in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add team-attention/plugins-for-claude-natives --skill gmail -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/gmail, .gemini/skills/gmail, .github/skills/gmail and .opencode/skills/gmail in your project.

What does Gmail need to run?

Going by SKILL.md and its folder, Gmail needs Python for the scripts in its folder and the command-line tools its instructions call (uv). Our summary lists: Python 3.

Does Gmail access the network?

SKILL.md names 1 domain. In commands or code: mail.google.com; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Gmail safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Gmail use?

Gmail is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Gmail use?

About 967 tokens (SKILL.md is roughly 3.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 2k tokens, read only when the agent opens those files.

What are the alternatives to Gmail?

Skills that share tags, products or a category with Gmail: Career-Ops Gmail Lead Plugin (career-ops-hq/career-ops, 74k stars), Connect Apps with Composio (ComposioHQ/awesome-claude-skills, 77k stars), Gmail Email (open-gitagent/gitagent, 710 stars) and Zele (remorses/zele, 299 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gmail?

team-attention (a GitHub organization) maintains it in team-attention/plugins-for-claude-natives, which has 825 GitHub stars. The repository holds 16 skills in this directory. The repository was last updated on April 20, 2026.

Source: team-attention/plugins-for-claude-natives on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Gmail

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

Gmail Skill

Account Setup

Email Sending Workflow (5 Steps)

Workflow Example: "Send a meeting email to John"

CLI Quick Reference

View Email in Web

File Structure

Error Handling

Files

Compare with similar skills

Similar skills

More from team-attention/plugins-for-claude-natives

Related

Questions about Gmail