What are Claude Code Skills?

Claude Code Skills are reusable prompt templates stored as markdown files in your project's .claude/skills/ directory. They let you codify best practices and common workflows into slash commands that Claude follows consistently.

How do I create a Claude Code Skill?

Create a markdown file in .claude/skills/ with instructions for Claude. The filename becomes the command name — for example, .claude/skills/code-review.md can be invoked with /code-review during a Claude Code session.

Can I share skills with my team?

Yes. Skills stored in .claude/skills/ can be committed to version control so every team member has access to the same standardized workflows. You can also organize skills into subdirectories by category.

What is the difference between project and global skills?

Project skills (.claude/skills/) are specific to the current project and are committed to git. Global skills (~/.claude/skills/) are personal skills available across all your projects.

email-cli

New

6Community RegistryGeneralby tnm

Send emails via Google Workspace, Proton Mail, or SMTP

Community PluginView Source

Overview

A simple CLI for agents to send emails. Supports AgentMail, Google Workspace, Proton Mail, and generic SMTP.

Install

Install Script (requires Go)

bash

curl -fsSL https://raw.githubusercontent.com/tnm/email-cli/main/email/install.sh | bash

Installs email-cli into ~/.local/bin by default. If that directory is not on your PATH:

bash

export PATH="$HOME/.local/bin:$PATH"

Or install from a local checkout:

bash

git clone https://github.com/tnm/email-cli
cd email-cli/email
./install.sh

Go Install

bash

go install github.com/tnm/email-cli@latest

Or build from source:

bash

git clone https://github.com/tnm/email-cli
cd email-cli/email
go build -o email-cli .

Claude Code Plugin

Install as a Claude Code plugin for AI agent access:

bash

# Add the marketplace
/plugin marketplace add tnm/email-cli

# Install the plugin
/plugin install email-cli@email-cli

# Or load locally during development
claude --plugin-dir /path/to/email-cli

Once installed, Claude automatically uses email-cli when you ask it to send emails.

Quick Start

bash

# Add a provider (interactive)
email-cli config add mymail

# Send an email
email-cli send -t [email protected] -s "Hello" -m "Message body"

Configuration

Config is stored at ~/.config/email-cli/config.json

Security

email-cli follows a pragmatic local-file security model:

•Secrets are stored in plaintext in ~/.config/email-cli/config.json by default.
•On macOS, you can use --use-keychain to store secrets in macOS Keychain instead.
•File permissions are restricted to owner-only (0600) when writing config.
•email-cli config show redacts secrets by default.
•email-cli config show --show-secrets prints raw secrets and should be treated as sensitive.

macOS Keychain Support

On macOS, you can store secrets in the system Keychain instead of the config file:

bash

# Store credentials in Keychain when adding a provider
email-cli config add --name agent \
  --type agentmail \
  --api-key "am_..." \
  --inbox-id "[email protected]" \
  --use-keychain

# Update a secret and store in Keychain
email-cli config set --use-keychain mymail password "new-password"

When using Keychain, the config file stores a reference like keychain:mymail/password instead of the actual secret. The secret is resolved from Keychain at runtime.

Benefits:

•Secrets never appear in the config file
•Protected by macOS Keychain security (Touch ID, password, etc.)
•Secrets survive config file inspection

Note: Keychain support is only available on macOS.

Operational Guidance

•Avoid passing secrets directly on command lines when possible (--api-key, --password, --access-token, --refresh-token) because shell history and process inspection may expose them.
•Use --use-keychain on macOS for sensitive credentials.
•Prefer app-specific passwords for SMTP providers (for Gmail, use an App Password).
•Rotate credentials immediately if a machine, shell history, or agent transcript is exposed.
•For install safety, prefer reviewing install.sh from a pinned version tag before running it.

Interactive Mode (for humans)

bash

email-cli config add mymail

Walks you through provider selection and credential entry.

Non-Interactive Mode (for scripts/agents)

bash

email-cli config add --name agent \
  --type agentmail \
  --api-key "am_..." \
  --inbox-id "[email protected]" \
  --default

No OAuth, no app passwords, no local servers. Just an API key from agentmail.to. Free tier: 3 inboxes, 3k emails/month.

bash

email-cli config add --name gmail-smtp \
  --type smtp \
  --from [email protected] \
  --host smtp.gmail.com \
  --port 587 \
  --username [email protected] \
  --password "$GMAIL_APP_PASSWORD" \
  --tls \
  --default

Use this when you want the fastest setup for humans and agents. It avoids Google Cloud OAuth client setup.

bash

email-cli config add --name mymail \
  --type smtp \
  --from [email protected] \
  --host smtp.example.com \
  --port 587 \
  --username [email protected] \
  --password "secret" \
  --tls

bash

email-cli config add --name proton \
  --type proton \
  --from [email protected] \
  --username [email protected] \
  --password "bridge-password"

bash

email-cli config add --name google \
  --type google \
  --from [email protected] \
  --client-id "xxx.apps.googleusercontent.com" \
  --client-secret "xxx"

By default this starts OAuth device flow and prints a verification URL/code in your terminal. To force localhost callback flow instead:

bash

email-cli config add --name google \
  --type google \
  --from [email protected] \
  --client-id "xxx.apps.googleusercontent.com" \
  --client-secret "xxx" \
  --oauth-method local

Config Commands

bash

# List providers
email-cli config list

# Show config as JSON (useful for agents)
email-cli config show                     # full config (secrets redacted)
email-cli config show mymail              # specific provider (secrets redacted)
email-cli config show --show-secrets      # include secrets/tokens
email-cli config show --show-secrets mymail

# Set individual values
email-cli config set mymail password "new-password"
email-cli config set mymail host smtp.newserver.com

# Set default provider
email-cli config default mymail

# Remove provider
email-cli config remove mymail

# Show config file path
email-cli config path

Config Set Keys

Provider	Available Keys
AgentMail	`api-key`, `inbox-id`
SMTP	`from`, `host`, `port`, `username`, `password`, `tls`
Proton	`from`, `host`, `port`, `username`, `password`
Google	`from`, `client-id`, `client-secret`, `access-token`, `refresh-token`

Sending Email

Basic Usage

bash

email-cli send -t [email protected] -s "Subject" -m "Body"

Options

Flag	Short	Description
`--to`	`-t`	Recipient(s) - required, repeatable
`--subject`	`-s`	Subject line - required
`--body`	`-m`	Message body
`--cc`	`-c`	CC recipient(s)
`--bcc`	`-b`	BCC recipient(s)
`--attach`	`-a`	File attachment(s)
`--html`	Treat body as HTML
`--provider`	`-p`	Use specific provider

Examples

bash

# Multiple recipients
email-cli send -t [email protected] -t [email protected] -s "Team Update" -m "Hello team"

# With CC/BCC
email-cli send -t [email protected] -c [email protected] -b [email protected] -s "Subject" -m "Body"

# HTML email
email-cli send -t [email protected] -s "Newsletter" -m "<h1>Hello</h1><p>World</p>" --html

# Attachments
email-cli send -t [email protected] -s "Report" -m "See attached" -a report.pdf -a data.csv

# Read body from stdin
cat message.txt | email-cli send -t [email protected] -s "From file"
echo "Quick message" | email-cli send -t [email protected] -s "Piped"

# Use specific provider
email-cli send -p work -t [email protected] -s "Subject" -m "Body"

Provider Setup

AgentMail (Easiest)

AgentMail is email infrastructure designed for AI agents. No OAuth, no app passwords, no local servers — just an API key.

Sign up at agentmail.to
Create an API key in the console
Create an inbox (or use the API to create one)
Configure:

bash

email-cli config add --name agent \
  --type agentmail \
  --api-key "am_..." \
  --inbox-id "[email protected]" \
  --default

Free tier: 3 inboxes, 3,000 emails/month, no credit card required.

Note: You'll send from @agentmail.to addresses unless you add a custom domain (paid plans).

Gmail (Recommended for Lowest Friction)

Use Gmail over SMTP with an App Password.

Turn on Google 2-Step Verification.
Create an App Password at Google App Passwords.
Configure email-cli:

bash

email-cli config add --name gmail-smtp \
  --type smtp \
  --from [email protected] \
  --host smtp.gmail.com \
  --port 587 \
  --username [email protected] \
  --password "YOUR_APP_PASSWORD" \
  --tls \
  --default

Notes:

•This is the simplest path for agent-driven setup.
•Agents cannot create App Passwords for users; the user must do that account-security step once.

Google Workspace (Gmail API)

Uses Gmail API with OAuth2.

email-cli defaults to OAuth device flow for Google setup, so you do not need a localhost callback server in the common case. This path requires Google Cloud OAuth project setup.

Create a project in Google Cloud Console
Enable the Gmail API
Create OAuth2 credentials (Desktop app type)
Run email-cli config add google and complete device auth in terminal
Optional for local callback mode: add http://127.0.0.1:8089/callback to authorized redirect URIs and run with --oauth-method local

If you already have tokens, you can set them directly:

bash

email-cli config add --name google \
  --type google \
  --from [email protected] \
  --client-id "YOUR_CLIENT_ID" \
  --client-secret "YOUR_CLIENT_SECRET" \
  --access-token "YOUR_ACCESS_TOKEN" \
  --refresh-token "YOUR_REFRESH_TOKEN"

Proton Mail

Uses Proton Mail Bridge which runs a local SMTP server.

Install and run Proton Mail Bridge
Get the bridge password from Bridge settings (not your account password)
Configure:

bash

# Interactive
email-cli config add proton

# Non-interactive
email-cli config add --name proton \
  --type proton \
  --from [email protected] \
  --username [email protected] \
  --password "BRIDGE_PASSWORD"

Default bridge address: 127.0.0.1:1025

Generic SMTP

Works with any SMTP server: SendGrid, Mailgun, Fastmail, AWS SES, etc.

bash

# Interactive
email-cli config add smtp

# Non-interactive (SendGrid example)
email-cli config add --name sendgrid \
  --type smtp \
  --from [email protected] \
  --host smtp.sendgrid.net \
  --port 587 \
  --username apikey \
  --password "SG.xxxx" \
  --tls

For AI Agents

This CLI is designed to be easily used by AI agents and automation.

Recommended Setup Order

Use this order when helping users configure email:

AgentMail first — easiest, just needs API key + inbox ID
For existing email accounts, try SMTP
For Gmail, prefer smtp.gmail.com + App Password
Use Google API only if the user explicitly wants Gmail API/OAuth features
Use Proton Bridge only when the user is on Proton Mail

Agent Setup Playbook

Check for an existing provider:

bash

email-cli config list

If no provider exists, recommend AgentMail for simplest setup:

bash

email-cli config add --name agent \
  --type agentmail \
  --api-key "am_..." \
  --inbox-id "[email protected]" \
  --default

Or for existing email, collect SMTP details and configure:

bash

email-cli config add --name agent-mail \
  --type smtp \
  --from "$EMAIL_FROM" \
  --host "$SMTP_HOST" \
  --port "$SMTP_PORT" \
  --username "$SMTP_USER" \
  --password "$SMTP_PASS" \
  --default

Send:

bash

email-cli send -t "$TO" -s "$SUBJECT" -m "$BODY"

Claude Code Plugin

The easiest way to use email-cli with Claude Code:

bash

/plugin marketplace add tnm/email-cli
/plugin install email-cli@email-cli

Claude will automatically invoke the email skill when you ask it to send emails. The skill includes full documentation so Claude knows all available options.

Simple Interface

bash

# Predictable, scriptable
email-cli send -t "$TO" -s "$SUBJECT" -m "$BODY"

# Exit codes: 0 = success, non-zero = failure
email-cli send -t [email protected] -s "Test" -m "Hello" && echo "Sent!"

Pipe Content

bash

# Pipe generated content
echo "$GENERATED_REPORT" | email-cli send -t [email protected] -s "Daily Report"

# From files
cat analysis.txt | email-cli send -t [email protected] -s "Analysis Results"

Non-Interactive Config

bash

# Set up without prompts
email-cli config add --name agent-mail \
  --type smtp \
  --from [email protected] \
  --host smtp.example.com \
  --port 587 \
  --username [email protected] \
  --password "$SMTP_PASSWORD" \
  --default

# Update credentials programmatically
email-cli config set agent-mail password "$NEW_PASSWORD"

JSON Output

bash

# Get config as JSON for parsing (secrets are redacted by default)
email-cli config show
email-cli config show agent-mail

# Include secrets/tokens only when needed
email-cli config show --show-secrets agent-mail

Environment Variables

You can use environment variables in scripts:

bash

email-cli config add --name mymail \
  --type smtp \
  --from "$EMAIL_FROM" \
  --host "$SMTP_HOST" \
  --port "$SMTP_PORT" \
  --username "$SMTP_USER" \
  --password "$SMTP_PASS"

Config File Format

~/.config/email-cli/config.json:

json

{
  "default_provider": "agent",
  "providers": {
    "agent": {
      "type": "agentmail",
      "name": "agent",
      "agentmail": {
        "api_key": "am_...",
        "inbox_id": "[email protected]"
      }
    },
    "work": {
      "type": "google",
      "name": "work",
      "from": "[email protected]",
      "google": {
        "client_id": "...",
        "client_secret": "...",
        "access_token": "...",
        "refresh_token": "...",
        "token_expiry": "2024-01-01T00:00:00Z"
      }
    },
    "personal": {
      "type": "smtp",
      "name": "personal",
      "from": "[email protected]",
      "smtp": {
        "host": "smtp.fastmail.com",
        "port": 587,
        "username": "[email protected]",
        "password": "app-password",
        "use_tls": true
      }
    }
  }
}

Exit Codes

Code	Meaning
0	Success
1	Error (config, auth, send failure, etc.)

License

MIT

Install & Usage

Create the skills directory

mkdir -p .claude/skills

Download the skill file

mkdir -p .claude/skills && curl -o .claude/skills/email-cli.md https://raw.githubusercontent.com/tnm/email-cli/main/SKILL.md

Invoke in Claude Code

/email-cli

View source on GitHub

Frequently Asked Questions

What is email-cli?

Send emails via Google Workspace, Proton Mail, or SMTP

How to install email-cli?

To install email-cli, create the .claude/skills directory in your project, then run the curl command to download the skill file. Once installed, invoke it in Claude Code with /email-cli.

What is email-cli best for?

email-cli is a community categorized under General. Created by tnm.