Agent skill

Gmail

by refly-ai in refly-ai/refly-skills

Integrate with Gmail for email management and automation. An agent skill from refly-ai/refly-skills.

No licenceAuto-check passedProductivity & Automation

Install Gmail

skills CLI
$ npx skills add refly-ai/refly-skills --skill gmail -a claude-code

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

GitHub CLI
$ gh skill install refly-ai/refly-skills 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/refly-ai/refly-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/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/

Facts

Skill name
gmail
GitHub stars
204
Token cost
~265 tokens
SKILL.md length
64 words
Files
2
Skills in repo
48
Repo updated
First seen
Licence
None found

At a glance

Integrate with Gmail for email management and automation. An agent skill from refly-ai/refly-skills.

  • Send and compose emails with attachments
  • SKILL.md covers Installation and Usage
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Read and search emails by criteria

What it does

Gmail is an agent skill from refly-ai/refly-skills. Integrate with Gmail for email management and automation. Use when you need to: (1) send and compose emails with attachments, (2) read and search emails by criteria, (3) manage drafts and email labels, or (4) reply to email threads and conversations.

Its SKILL.md is about 270 tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `README.md`).

It sits in Productivity & Automation, covering Email management. It works with Gmail. The repository describes itself as: Refly skills repository.

When your agent uses it

  • Send and compose emails with attachments
  • Read and search emails by criteria
  • Manage drafts and email labels
  • Reply to email threads and conversations

Example prompts

  • “/gmail”

What it can do on your machine

Read from SKILL.md and the folder at commit 5a546d2. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    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 265 tokens when it runs. Until then it costs about 64 tokens; SKILL.md has 64 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~64
When it runs · the whole SKILL.md, loaded when a task matches
~265

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); files beside SKILL.md are not scanned.

SKILL.md

Without a licence we can't republish the file, so here is its outline and opening line. It has 64 words (~265 tokens).

“Integrate with Gmail for email management and automation. Use when you need to: (1) send and compose emails with attachments, (2) read and search emails by criteria, (3) manage drafts and email labels, or (4) reply to email threads and…”

— opening of SKILL.md by refly-ai
name
gmail
skillId
skp-law87xgmyelzh4rgftrul23w
workflowId
c-xqkgbxalqguze8wt9a1a4llc
triggers
- gmail - email - send email - read email - compose email
tags
- email - productivity - communication - google
version
1.0.0

Read the full SKILL.md on GitHub

Files

SKILL.md and 1 other file in skills/gmail of refly-ai/refly-skills.

  • SKILL.md
  • README.md

Open the folder on GitHubat commit 5a546d2

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
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gmail this skillrefly-ai/refly-skills204—~265Automated safety check: PassNone
Career-Ops Gmail Lead Plugincareer-ops-hq/career-ops74k—~233Automated safety check: NotesMIT
Gmailteam-attention/plugins-for-claude-natives825—~967Automated safety check: PassMIT
Connect Apps with ComposioComposioHQ/awesome-claude-skills77k3 repos~557Automated safety check: PassNone
Gmail Emailopen-gitagent/gitagent710—~235Automated safety check: NotesMIT
Zeleremorses/zele299—~1.3kAutomated safety check: PassNone

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
  • Gmail

    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.

    825 GitHub stars~967 tokensUpdated 5 mo ago
    Productivity & AutomationAuto-check passed
  • 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

More from refly-ai/refly-skills

All 48 skills in this repo
  • Airtable

    refly-ai/refly-skills

    Integrate with Airtable for database management. An agent skill from refly-ai/refly-skills.

    204 GitHub stars~493 tokensUpdated 2 mo ago
    Auto-check passed
  • Apollo

    refly-ai/refly-skills

    Search sales leads with Apollo.io. An agent skill from refly-ai/refly-skills.

    204 GitHub stars~470 tokensUpdated 2 mo ago
    Auto-check passed
  • Asana

    refly-ai/refly-skills

    Integrate with Asana for task management. An agent skill from refly-ai/refly-skills.

    204 GitHub stars~470 tokensUpdated 2 mo ago
    Auto-check passed
  • Excel

    refly-ai/refly-skills

    Integrate with Microsoft Excel for spreadsheets. An agent skill from refly-ai/refly-skills.

    204 GitHub stars~545 tokensUpdated 2 mo ago
    Auto-check passed
  • Fal Audio

    refly-ai/refly-skills

    Generate AI audio using Fal.ai audio models. An agent skill from refly-ai/refly-skills.

    204 GitHub stars~602 tokensUpdated 2 mo ago
    Auto-check passed
  • Fal Image

    refly-ai/refly-skills

    Generate AI images using Fal.ai Flux models. An agent skill from refly-ai/refly-skills.

    204 GitHub stars~847 tokensUpdated 2 mo ago
    Auto-check passed

Works with

Questions about Gmail

What does Gmail do?

Integrate with Gmail for email management and automation. An agent skill from refly-ai/refly-skills. Gmail is an agent skill from refly-ai/refly-skills. Integrate with Gmail for email management and automation.

When should I use Gmail?

Gmail fits situations like: send and compose emails with attachments; read and search emails by criteria; manage drafts and email labels; reply to email threads and conversations.

How do I install Gmail in Claude Code?

Run `npx skills add refly-ai/refly-skills --skill gmail -a claude-code`. Or copy the skill folder (skills/gmail in refly-ai/refly-skills) 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 refly-ai/refly-skills --skill gmail -a codex`. Or copy the skill folder (skills/gmail in refly-ai/refly-skills) 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 refly-ai/refly-skills --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?

SKILL.md names no scripts, command-line tools or credentials: Gmail is instructions for the agent only.

Does Gmail access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. 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. Review the folder before installing.

What licence does Gmail use?

No licence was found for Gmail or its repository. Without one, default copyright applies: ask the author before reusing or redistributing it.

How many tokens does Gmail use?

About 265 tokens (SKILL.md is roughly 1.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

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), Gmail (team-attention/plugins-for-claude-natives, 825 stars), Connect Apps with Composio (ComposioHQ/awesome-claude-skills, 77k stars) and Gmail Email (open-gitagent/gitagent, 710 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gmail?

refly-ai (a GitHub organization) maintains it in refly-ai/refly-skills, which has 204 GitHub stars. The repository holds 48 skills in this directory. The repository was last updated on July 20, 2026.

Source: refly-ai/refly-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.