Manage your Gmail inbox from Claude Code. An agent skill from earlyaidopters/claudeclaw.

No licenceAuto-check: notesProductivity & Automation

Install Gmail

skills CLI
$ npx skills add earlyaidopters/claudeclaw --skill gmail -a claude-code

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

GitHub CLI
$ gh skill install earlyaidopters/claudeclaw 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/earlyaidopters/claudeclaw.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
173
Token cost
~1.3k tokens
SKILL.md length
422 words
Files
1
Skills in repo
5
Repo updated
First seen
Licence
None found

At a glance

Manage your Gmail inbox from Claude Code. An agent skill from earlyaidopters/claudeclaw.

  • Works in 4 steps: Run list --all to show all inbox emails → Display as a table with columns: #,… → Ask the user which to move and where → …
  • Tasks that involve Email management
  • SKILL.md covers Purpose, Environment, Commands and Workflow, plus 4 more sections
  • Calls python3

What it does

Gmail is an agent skill from earlyaidopters/claudeclaw. Manage your Gmail inbox from Claude Code. List, read, triage, reply, send, and create filters.

Its SKILL.md is about 1.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Productivity & Automation, covering Email management. It works with Gmail. The repository describes itself as: Claude Code CLI as a personal Telegram bot — voice, memory, scheduled tasks, all your skills from your pocket.

When your agent uses it

  • Tasks that involve Email management

Example prompts

  • “/gmail”

Requirements

  • Python 3
  • Pre-approved tools (allowed-tools): Bash(CLAUDECLAW_DIR=* ~/.venv/bin/python3 ~/.config/gmail/gmail.py *)

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

  1. Run list --all to show all inbox emails
  2. Display as a table with columns: #, Unread, From, Subject, Replies, Time
  3. Ask the user which to move and where
  4. Run move for each, confirm results

What it can do on your machine

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

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash(CLAUDECLAW_DIR=* ~/.venv/bin/python3 ~/.config/gmail/gmail.py *)

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • python3

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

  • Network

    Links to these hosts (documentation or services it may open):

    • console.cloud.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 1.3k tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 422 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~1.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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:15
    ent variables, loaded from ClaudeClaw's `.env` via `CLAUDECLAW_DIR`. Every command MUST use this prefix:
  • NoteMentions a .env fileSKILL.md:21
    Your `.env` should contain:

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 422 words (~1,251 tokens).

“Read, triage, reply, and send emails from your Gmail inbox via Claude Code.”

— opening of SKILL.md by earlyaidopters
name
gmail
allowed-tools
Bash(CLAUDECLAW_DIR=* ~/.venv/bin/python3 ~/.config/gmail/gmail.py *)

Read the full SKILL.md on GitHub

Files

Just SKILL.md in skills/gmail of earlyaidopters/claudeclaw.

Open the folder on GitHubat commit 545a6d1

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 skillearlyaidopters/claudeclaw173—~1.3kAutomated safety check: NotesNone
Career-Ops Gmail Lead Plugincareer-ops-hq/career-ops74k—~233Automated safety check: NotesMIT
Gmailteam-attention/plugins-for-claude-natives827—~967Automated safety check: PassMIT
Connect Apps with ComposioComposioHQ/awesome-claude-skills77k3 repos~557Automated safety check: PassNone
Gmail Emailopen-gitagent/gitagent710—~235Automated safety check: NotesMIT
Gmclibadlogic/pi-skills2.6k1 repos~470Automated safety check: PassMIT

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.

    827 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
  • Gmcli

    badlogic/pi-skills

    Gmail CLI for searching emails, reading threads, sending messages, managing drafts, and handling labels/attachments.

    2.6k GitHub starsUsed in 1 repo~470 tokens
    Productivity & AutomationAuto-check passed
  • 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.5k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed

More from earlyaidopters/claudeclaw

  • Tldr

    earlyaidopters/claudeclaw

    Summarize the current conversation into a TLDR note and save it to your notes folder.

    173 GitHub stars~953 tokensUpdated 5 mo ago
    Auto-check passed
  • Google Calendar

    earlyaidopters/claudeclaw

    Manage your Google Calendar from Claude Code. An agent skill from earlyaidopters/claudeclaw.

    173 GitHub stars~1.2k tokensUpdated 5 mo ago
    Auto-check: notes
  • Slack

    earlyaidopters/claudeclaw

    Manage Slack from Claude Code. An agent skill from earlyaidopters/claudeclaw.

    173 GitHub stars~936 tokensUpdated 5 mo ago
    Auto-check: notes
  • Timezone

    earlyaidopters/claudeclaw

    Show current times across Mark's key locations. An agent skill from earlyaidopters/claudeclaw.

    173 GitHub stars~258 tokensUpdated 5 mo ago
    Auto-check passed

Works with

Questions about Gmail

What does Gmail do?

Manage your Gmail inbox from Claude Code. An agent skill from earlyaidopters/claudeclaw. Gmail is an agent skill from earlyaidopters/claudeclaw. Manage your Gmail inbox from Claude Code.

When should I use Gmail?

Gmail fits situations like: tasks that involve Email management.

How do I install Gmail in Claude Code?

Run `npx skills add earlyaidopters/claudeclaw --skill gmail -a claude-code`. Or copy the skill folder (skills/gmail in earlyaidopters/claudeclaw) 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 earlyaidopters/claudeclaw --skill gmail -a codex`. Or copy the skill folder (skills/gmail in earlyaidopters/claudeclaw) 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 earlyaidopters/claudeclaw --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 the command-line tools its instructions call (python3). Our summary lists: Python 3. Its frontmatter pre-approves these tools: Bash(CLAUDECLAW_DIR=* ~/.venv/bin/python3 ~/.config/gmail/gmail.py *).

Does Gmail access the network?

SKILL.md names 1 domain. As links in the text: console.cloud.google.com. This is read from the text; nothing was executed.

Is Gmail safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. 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 1.3k tokens (SKILL.md is roughly 5k 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, 827 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?

earlyaidopters (a GitHub organization) maintains it in earlyaidopters/claudeclaw, which has 173 GitHub stars. The repository holds 5 skills in this directory. The repository was last updated on April 14, 2026.

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