Agent skill

Gmail Email

by open-gitagent in open-gitagent/gitagent

Send emails via Gmail SMTP using App Password authentication.

MITAuto-check: notesProductivity & Automation

Install Gmail Email

skills CLI
$ npx skills add open-gitagent/gitagent --skill gmail-email -a claude-code

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

GitHub CLI
$ gh skill install open-gitagent/gitagent gmail-email --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/open-gitagent/gitagent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/gmail-email .claude/skills/gmail-email && 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-email
GitHub stars
710
Token cost
~235 tokens
SKILL.md length
63 words
Files
2 (incl. scripts)
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Send emails via Gmail SMTP using App Password authentication.

  • Works in 3 steps: Enable 2-Factor Authentication on your… → Generate App Password → Configure credentials
  • Tasks that involve Email management
  • SKILL.md covers Setup, Usage and Requirements
  • Runs Python scripts from its folder; calls python3; needs GMAIL_APP_PASSWORD

What it does

Gmail Email is an agent skill from open-gitagent/gitagent. Send emails via Gmail SMTP using App Password authentication.

Its SKILL.md is about 240 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/send_email.py`).

It sits in Productivity & Automation, covering Email management and Transactional email. It works with Gmail. The repository describes itself as: A universal git-native AI agent framework. Your agent lives inside a git repo — identity, rules, memory, tools, and skills are all version-controlled files. The licence is MIT.

When your agent uses it

  • Tasks that involve Email management
  • Tasks that involve Transactional email

Example prompts

  • “/gmail-email”

Requirements

  • Python 3

Workflow steps

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

  1. Enable 2-Factor Authentication on your Gmail account
  2. Generate App Password
  3. Configure credentials

What it can do on your machine

Read from SKILL.md and the folder at commit ed59584. 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 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python3

    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 these keys or tokens, usually read from environment variables:

    • GMAIL_APP_PASSWORD

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Gmail Email loads about 235 tokens when it runs. Until then it costs about 18 tokens; SKILL.md has 63 words of instructions outside code blocks.

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

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:25
    Or create a `.env` file in the skill directory:

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 open-gitagent/gitagent at commit ed59584, republished under its MIT licence (© open-gitagent). 63 words, ~235 tokens.

Download SKILL.mdSave it as .claude/skills/gmail-email/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
gmail-email
description
Send emails via Gmail SMTP using App Password authentication.

Gmail Email Skill

Send emails via Gmail SMTP.

Setup

  1. Enable 2-Factor Authentication on your Gmail account

  2. Generate App Password:

  3. Configure credentials:

    bash
    export GMAIL_USER="your-email@gmail.com"
    export GMAIL_APP_PASSWORD="your-16-char-app-password"

    Or create a .env file in the skill directory:

    GMAIL_USER=your-email@gmail.com
    GMAIL_APP_PASSWORD=your-16-char-app-password

Usage

bash
python3 scripts/send_email.py \
  --to "recipient@example.com" \
  --subject "Subject line" \
  --body "Email body text"

Requirements

  • Python 3.6+
  • No additional packages needed (uses stdlib smtplib)

© open-gitagent, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in skills/gmail-email of open-gitagent/gitagent.

  • SKILL.md
  • scripts/send_email.py

Open the folder on GitHubat commit ed59584

Compare with similar skills

Gmail Email 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 Email compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Gmail Email this skillopen-gitagent/gitagent710—~235Automated safety check: NotesMIT
Zeleremorses/zele299—~1.3kAutomated safety check: PassNone
Inbox Placement Monitoraaron-he-zhu/aaron-marketing-skills2.9k2 repos~3.6kAutomated safety check: PassApache-2.0
Smtp Email Senderopenakita/openakita2k—~693Automated safety check: NotesAGPL-3.0
Deliverability Test Publicgrowthenginenowoslawski/coldoutboundskills740—~1kAutomated safety check: PassMIT
Google Workspaceericrisco/rsc-harness156—~3.2kAutomated safety check: PassMIT

Similar skills

  • 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
  • Inbox Placement Monitor

    aaron-he-zhu/aaron-marketing-skills

    A skill your agent uses when the user asks to "track where my emails are actually landing after I send", "read my seed-list inbox vs spam vs promotions results", "trend my Gmail Postmaster /…

    2.9k GitHub starsUsed in 2 repos~3.6k tokens
    Productivity & AutomationAuto-check passed
  • Smtp Email Sender

    openakita/openakita

    Send emails via SMTP (Gmail, Outlook, etc.). An agent skill from openakita/openakita.

    2k GitHub stars~693 tokensUpdated 13 days ago
    Backend & APIsAuto-check: notes
  • Deliverability Test Public

    growthenginenowoslawski/coldoutboundskills

    Compare reply rates, bounce rates, and positive reply rates broken down by inbox type (SMTP / Gmail / Outlook) for a Smartlead account.

    740 GitHub stars~1k tokensUpdated yesterday
    Backend & APIsAuto-check passed
  • Google Workspace

    ericrisco/rsc-harness

    A skill your agent uses when server-side code reads or writes Gmail, Drive, Calendar, or Sheets with a GCP service account and no human in the OAuth loop: picking the auth mode (app-owned vs…

    156 GitHub stars~3.2k tokensUpdated today
    Backend & APIsAuto-check passed
  • Email Deliverability

    ericrisco/rsc-harness

    A skill your agent uses when mail already sent lands in spam, is rejected, or fails the Gmail/Yahoo bulk-sender checks and the fix is authentication and reputation, not the sending code…

    156 GitHub stars~2.3k tokensUpdated today
    Backend & APIsAuto-check passed

Works with

Questions about Gmail Email

What does Gmail Email do?

Send emails via Gmail SMTP using App Password authentication. Gmail Email is an agent skill from open-gitagent/gitagent. Send emails via Gmail SMTP using App Password authentication.

When should I use Gmail Email?

Gmail Email fits situations like: tasks that involve Email management; tasks that involve Transactional email.

How do I install Gmail Email in Claude Code?

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

How do I install Gmail Email in Codex?

Run `npx skills add open-gitagent/gitagent --skill gmail-email -a codex`. Or copy the skill folder (skills/gmail-email in open-gitagent/gitagent) into .agents/skills/gmail-email in your project. Codex loads it when a task matches its description.

Can I use Gmail Email 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 open-gitagent/gitagent --skill gmail-email -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-email, .gemini/skills/gmail-email, .github/skills/gmail-email and .opencode/skills/gmail-email in your project.

What does Gmail Email need to run?

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

Does Gmail Email 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 Email 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. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Gmail Email use?

Gmail Email 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 Email use?

About 235 tokens (SKILL.md is roughly 940 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 Email?

Skills that share tags, products or a category with Gmail Email: Zele (remorses/zele, 299 stars), Inbox Placement Monitor (aaron-he-zhu/aaron-marketing-skills, 2.9k stars), Smtp Email Sender (openakita/openakita, 2k stars) and Deliverability Test Public (growthenginenowoslawski/coldoutboundskills, 740 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Gmail Email?

open-gitagent (a GitHub organization) maintains it in open-gitagent/gitagent, which has 710 GitHub stars. The repository was last updated on August 20, 2026.

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