claude-email
AI-powered email management and marketing skill for Claude Code. Inbox triage, composition, quality review, deliverability audit, automation sequences, and marketing strategy.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/agricidaniel-claude-email)HTML
<a href="/listings/agricidaniel-claude-email"><img src="/api/listings/agricidaniel-claude-email/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
These steps run a script from the network that findsafeskills does not scan.
curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-email/main/install.sh | bash
After installation, run `/email` in Claude Code to start the interactive wizard.
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 272 lines · 4 findings marked
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- <p align="center">
- <img src="assets/header.jpeg" alt="Claude Email — AI-Powered Email Management" width="100%">
- </p>
- # Claude Email — AI-Powered Email Management and Marketing
- > Professional email management, deliverability optimization, and marketing strategy powered by Claude Code
- **6 sub-skills** | **4 agents** | **3 scripts** | **MIT License**
- ---
- ## Features
- - **Inbox Triage**: AI importance scoring, smart labeling, and contextual reply suggestions via Gmail/Outlook MCP
- - **Email Composition**: Proven copywriting frameworks (PAS, AIDA, BAB, FAB, 4Ps) with tone/voice matching
- - **Pre-Send Review**: 0-100 quality scoring across clarity, professionalism, CTA strength, tone, and technical quality
- - **Deliverability Audit**: SPF/DKIM/DMARC validation, blacklist monitoring, bulk sender compliance (Google/Yahoo/Microsoft 2024-2026)
- - **Automation Sequences**: Welcome series, nurture flows, re-engagement, abandoned cart, post-purchase drips
- - **Marketing Strategy**: Industry-specific templates with 90-day roadmap, KPI targets, and content calendars
- - **User Profiles**: Adaptive system learns your business type, platform, brand voice, and preferences
- ---
- ## Quick Start
- ```bash
- curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-email/main/install.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 28 on GitHub
- ```
- After installation, run `/email` in Claude Code to start the interactive wizard.
- ---
- ## Commands
- | Command | Description |
- |---------|-------------|
- | `/email` | Interactive mode with skill selection menu |
- | `/email check` | Inbox triage with importance scoring and reply suggestions |
- | `/email write` | Compose email using copywriting frameworks |
- | `/email review` | Quality review with 0-100 scoring and improvement suggestions |
- | `/email audit <domain>` | Deliverability audit (SPF/DKIM/DMARC, blacklists, compliance) |
- | `/email sequence <type>` | Design automation sequence (welcome, nurture, cart, etc.) |
- | `/email plan <business>` | Marketing strategy with 90-day roadmap |
- ---
- ## MCP Integration
- Claude Email integrates with email platforms via MCP servers:
- ### Required (for inbox features)
- - **Gmail**: [taylorwilsdon/google_workspace_mcp](https://github.com/taylorwilsdon/google_workspace_mcp)
- - **Microsoft 365**: [Softeria/ms-365-mcp-server](https://github.com/Softeria/ms-365-mcp-server)
- ### Optional (for advanced features)
- - **SendGrid**: [Garoth/sendgrid-mcp](https://github.com/Garoth/sendgrid-mcp) - Transactional email analytics
- - **Mailchimp**: Campaign management and automation
- - **Kit.com** (ConvertKit): Creator-focused email marketing
- At least one inbox MCP (Gmail or Outlook) is required for `/email check`. All other features work standalone.
- ---
- ## Architecture
- ```
- claude-email/
- ├── email/SKILL.md # Main orchestrator
- ├── skills/
- │ ├── email-check/SKILL.md # Inbox triage
- │ ├── email-write/SKILL.md # Composition
- │ ├── email-review/SKILL.md # Quality review
- │ ├── email-audit/SKILL.md # Deliverability
- │ ├── email-sequence/SKILL.md # Automation design
- │ └── email-plan/SKILL.md # Marketing strategy
- ├── agents/
- │ ├── email-deliverability.md # Technical validation
- │ ├── email-compliance.md # Legal/regulatory checks
- │ ├── email-content.md # Copywriting analysis
- │ └── email-inbox.md # Triage logic
- ├── scripts/
- │ ├── check_deliverability.py # SPF/DKIM/DMARC validation
- │ ├── analyze_email_html.py # HTML quality scoring
- │ └── score_subject_line.py # Subject line analysis
- ├── email/references/
- │ ├── deliverability-rules.md # DNS, authentication, reputation
- │ ├── benchmarks.md # Industry metrics
- │ ├── compliance.md # CAN-SPAM, GDPR, CASL
- │ ├── copy-frameworks.md # PAS, AIDA, BAB, FAB, 4Ps
- │ ├── technical-standards.md # HTML, rendering, accessibility
- │ └── mcp-integration.md # Platform-specific guides
- ├── skills/email-plan/assets/
- │ ├── local-business.md # Local/service business strategy
- │ ├── saas.md # SaaS strategy
- │ ├── ecommerce.md # E-commerce strategy
- │ ├── creator.md # Creator/influencer strategy
- │ ├── agency.md # Agency/B2B strategy
- │ └── generic.md # General business strategy
- └── hooks/
- ├── pre-send-check.sh # Pre-send validation hook
- └── validate-email-html.py # HTML quality gate
- ```
- ---
- ## Requirements
- - **Claude Code CLI** (latest version)
- - **Python 3.10+** (for deliverability scripts)
- - **Gmail MCP** or **Outlook MCP** (for inbox triage features)
- - **Optional**: `checkdmarc` Python package for advanced DNS validation
- ---
- ## Installation
- ### Unix/macOS (bash)
- ```bash
- curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-email/main/install.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 121 on GitHub
- ```
- ### Windows (PowerShell)
- ```powershell
- irm https://raw.githubusercontent.com/AgriciDaniel/claude-email/main/install.ps1 | iex
- Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
- Line 126 on GitHub
- ```
- ### Manual Installation
- ```bash
- git clone https://github.com/AgriciDaniel/claude-email.git
- cd claude-email
- chmod +x install.sh
- ./install.sh
- ```
- ---
- ## Uninstall
- ```bash
- curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-email/main/uninstall.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 142 on GitHub
- ```
- ---
- ## Examples
- ### Inbox Triage
- ```
- /email check
- # Returns:
- # - Importance scores (0-100) for each email
- # - Smart labels (urgent, actionable, informational, promotional)
- # - Contextual reply suggestions for top 5 emails
- ```
- ### Compose Marketing Email
- ```
- /email write
- # Interactive prompts:
- # - Email purpose (newsletter, promotion, announcement)
- # - Target audience
- # - Key message/offer
- # - CTA goal
- # - Tone/voice
- #
- # Generates email using appropriate framework (PAS, AIDA, etc.)
- ```
- ### Pre-Send Review
- ```
- /email review
- # Paste email content, receive:
- # - Overall score (0-100)
- # - Category scores: clarity, professionalism, CTA, tone, technical
- # - Specific improvement suggestions
- # - Subject line A/B test variants
- ```
- ### Deliverability Audit
- ```
- /email audit yourdomain.com
- # Checks:
- # - SPF/DKIM/DMARC DNS records
- # - Blacklist status (20+ databases)
- # - Google/Yahoo bulk sender compliance
- # - HTML rendering quality
- # - Spam score prediction
- ```
- ### Design Automation Sequence
- ```
- /email sequence welcome
- # Generates:
- # - 5-7 email sequence with timing recommendations
- # - Subject lines and preview text
- # - Full email copy for each message
- # - Branching logic based on engagement
- # - Success metrics and optimization tips
- ```
- ### Marketing Strategy
- ```
- /email plan saas
- # Delivers:
- # - 90-day roadmap with campaigns
- # - Segmentation strategy
- # - Content calendar
- # - KPI targets and benchmarks
- # - Platform/tool recommendations
- ```
- ---
- ## User Profile System
- On first run, `/email` generates an `email-profile.md` file in your project root with:
- - **Business type**: local business, SaaS, e-commerce, creator, agency, personal
- - **Primary email platform**: Gmail, Outlook, other
- - **Compliance regions**: US only, EU/GDPR, both
- - **Brand voice**: professional, friendly, casual, authoritative
- All sub-skills reference this profile to adapt recommendations. Delete `email-profile.md` to re-run onboarding.
- ---
- ## License
- MIT License - see [LICENSE](LICENSE) for details.
- ---
- ## Support
- For support, please use [GitHub Issues](https://github.com/AgriciDaniel/claude-email/issues) or [Discussions](https://github.com/AgriciDaniel/claude-email/discussions).
- ---
- ## Changelog
- See [CHANGELOG.md](CHANGELOG.md) for version history and updates.
- ---
- ## Related Skills
- - **[claude-seo](https://github.com/AgriciDaniel/claude-seo)**: SEO content optimization and strategy
- - **[claude-ads](https://github.com/AgriciDaniel/claude-ads)**: Paid advertising campaign management
- - **claude-skool**: Community and course management (coming soon)
- ---
- **Powered by Claude Code** | **[Agent Skills Open Standard](https://agentskills.io)**
- ---
- ## Author
- Built by [Agrici Daniel](https://agricidaniel.com/about) - AI Workflow Architect.
- - [Blog](https://agricidaniel.com/blog) - Deep dives on AI marketing automation
- - [AI Marketing Hub](https://www.skool.com/ai-marketing-hub) - Free community, 2,800+ members
- - [YouTube](https://www.youtube.com/@AgriciDaniel) - Tutorials and demos
- - [All open-source tools](https://github.com/AgriciDaniel)
install.ps1 · Bundled script · 129 lines · 1 finding marked
- # install.ps1 — Install claude-email skill ecosystem (Windows)
- # Usage:
- # iwr -useb https://raw.githubusercontent.com/AgriciDaniel/claude-email/main/install.ps1 | iex
- Note: Runs a downloaded PowerShell script (iex / Invoke-Expression)
- Line 3 on GitHub
- # Or:
- # powershell -ExecutionPolicy Bypass -File install.ps1
- $ErrorActionPreference = "Stop"
- $RepoUrl = "https://github.com/AgriciDaniel/claude-email"
- $SkillsDir = Join-Path $env:USERPROFILE ".claude\skills"
- $AgentsDir = Join-Path $env:USERPROFILE ".claude\agents"
- function Main {
- Write-Host "Installing claude-email skill ecosystem..." -ForegroundColor Cyan
- Write-Host ""
- # Check prerequisites
- Check-Prerequisites
- # Create target directories
- New-Item -ItemType Directory -Force -Path $SkillsDir | Out-Null
- New-Item -ItemType Directory -Force -Path $AgentsDir | Out-Null
- # Clone repo to temp directory
- $TempDir = Join-Path $env:TEMP "claude-email-$(Get-Random)"
- try {
- Write-Host "Cloning repository..."
- git clone --depth 1 $RepoUrl $TempDir 2>&1 | Out-Null
- # Copy main orchestrator skill
- Write-Host "Installing main orchestrator skill..."
- $EmailSkillDir = Join-Path $SkillsDir "email"
- Copy-Item -Path (Join-Path $TempDir "email") -Destination $EmailSkillDir -Recurse -Force
- # Copy sub-skills
- Write-Host "Installing sub-skills..."
- $SubSkillsPath = Join-Path $TempDir "skills"
- if (Test-Path $SubSkillsPath) {
- Get-ChildItem -Path $SubSkillsPath -Directory -Filter "email-*" | ForEach-Object {
- $SkillName = $_.Name
- Copy-Item -Path $_.FullName -Destination (Join-Path $SkillsDir $SkillName) -Recurse -Force
- Write-Host " ✓ $SkillName" -ForegroundColor Green
- }
- }
- # Copy agents
- Write-Host "Installing agents..."
- $AgentsPath = Join-Path $TempDir "agents"
- if (Test-Path $AgentsPath) {
- Get-ChildItem -Path $AgentsPath -File -Filter "email-*.md" | ForEach-Object {
- $AgentName = $_.Name
- Copy-Item -Path $_.FullName -Destination (Join-Path $AgentsDir $AgentName) -Force
- Write-Host " ✓ $AgentName" -ForegroundColor Green
- }
- }
- # Copy scripts
- $ScriptsPath = Join-Path $TempDir "scripts"
- if (Test-Path $ScriptsPath) {
- Write-Host "Installing scripts..."
- $TargetScriptsDir = Join-Path $EmailSkillDir "scripts"
- Copy-Item -Path $ScriptsPath -Destination $TargetScriptsDir -Recurse -Force
- }
- # Copy hooks
- $HooksPath = Join-Path $TempDir "hooks"
- if (Test-Path $HooksPath) {
- Write-Host "Installing hooks..."
- $TargetHooksDir = Join-Path $EmailSkillDir "hooks"
- Copy-Item -Path $HooksPath -Destination $TargetHooksDir -Recurse -Force
- }
- # Install Python dependencies
- $RequirementsFile = Join-Path $TempDir "requirements.txt"
- if (Test-Path $RequirementsFile) {
- Write-Host "Installing Python dependencies..."
- try {
- if (Get-Command pip3 -ErrorAction SilentlyContinue) {
- pip3 install -q -r $RequirementsFile 2>$null
- } elseif (Get-Command pip -ErrorAction SilentlyContinue) {
- pip install -q -r $RequirementsFile 2>$null
- } else {
- Write-Host " ⚠️ pip not found — skipping Python dependencies" -ForegroundColor Yellow
- }
- } catch {
- Write-Host " ⚠️ pip install failed — you may need to run: pip install -r requirements.txt" -ForegroundColor Yellow
- }
- }
- Write-Host ""
- Write-Host "✓ Installation complete!" -ForegroundColor Green
- Write-Host ""
- Write-Host "Usage:"
- Write-Host " /email — Interactive email assistant menu"
- Write-Host " /email check — Validate email before sending"
- Write-Host " /email write — Compose professional emails"
- Write-Host " /email review — Review and improve email drafts"
- Write-Host " /email audit — Analyze email deliverability"
- Write-Host " /email sequence — Build multi-email campaigns"
- Write-Host " /email plan — Design email strategy"
- Write-Host ""
- Write-Host "Skills installed at: $SkillsDir\email*"
- Write-Host "Agents installed at: $AgentsDir\email-*.md"
- Write-Host ""
- }
- finally {
- # Cleanup temp directory
- if (Test-Path $TempDir) {
- Remove-Item -Path $TempDir -Recurse -Force -ErrorAction SilentlyContinue
- }
- }
- }
- function Check-Prerequisites {
- if (-not (Get-Command python -ErrorAction SilentlyContinue)) {
- if (-not (Get-Command python3 -ErrorAction SilentlyContinue)) {
- Write-Host "Error: Python not found. Please install Python 3.7+." -ForegroundColor Red
- exit 1
- }
- }
- if (-not (Get-Command git -ErrorAction SilentlyContinue)) {
- Write-Host "Error: git not found. Please install git." -ForegroundColor Red
- exit 1
- }
- }
- # Run main function
- Main
install.sh · Bundled script · 116 lines · 1 finding marked
- #!/usr/bin/env bash
- # install.sh — Install claude-email skill ecosystem
- # Usage: curl -fsSL https://raw.githubusercontent.com/AgriciDaniel/claude-email/main/install.sh | bash
- Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
- Line 3 on GitHub
- set -euo pipefail
- REPO_URL="https://github.com/AgriciDaniel/claude-email"
- SKILLS_DIR="${HOME}/.claude/skills"
- AGENTS_DIR="${HOME}/.claude/agents"
- main() {
- echo "Installing claude-email skill ecosystem..."
- echo ""
- # Check prerequisites
- check_prerequisites
- # Create target directories
- mkdir -p "$SKILLS_DIR"
- mkdir -p "$AGENTS_DIR"
- # Clone repo to temp directory
- TEMP_DIR=$(mktemp -d)
- trap 'rm -rf "$TEMP_DIR"' EXIT
- echo "Cloning repository..."
- git clone --depth 1 "$REPO_URL" "$TEMP_DIR" >/dev/null 2>&1
- # Copy main orchestrator skill
- echo "Installing main orchestrator skill..."
- cp -r "$TEMP_DIR/email" "$SKILLS_DIR/"
- # Copy sub-skills
- echo "Installing sub-skills..."
- for skill_dir in "$TEMP_DIR/skills"/email-*; do
- if [[ -d "$skill_dir" ]]; then
- skill_name=$(basename "$skill_dir")
- cp -r "$skill_dir" "$SKILLS_DIR/"
- echo " ✓ $skill_name"
- fi
- done
- # Copy agents
- echo "Installing agents..."
- if [[ -d "$TEMP_DIR/agents" ]]; then
- for agent_file in "$TEMP_DIR/agents"/email-*.md; do
- if [[ -f "$agent_file" ]]; then
- agent_name=$(basename "$agent_file")
- cp "$agent_file" "$AGENTS_DIR/"
- echo " ✓ $agent_name"
- fi
- done
- fi
- # Copy scripts (if exists)
- if [[ -d "$TEMP_DIR/scripts" ]]; then
- echo "Installing scripts..."
- cp -r "$TEMP_DIR/scripts" "$SKILLS_DIR/email/"
- chmod +x "$SKILLS_DIR/email/scripts"/*.py 2>/dev/null || true
- fi
- # Copy hooks and make executable
- if [[ -d "$TEMP_DIR/hooks" ]]; then
- echo "Installing hooks..."
- cp -r "$TEMP_DIR/hooks" "$SKILLS_DIR/email/"
- chmod +x "$SKILLS_DIR/email/hooks"/*.sh 2>/dev/null || true
- chmod +x "$SKILLS_DIR/email/hooks"/*.py 2>/dev/null || true
- fi
- # Install Python dependencies
- if [[ -f "$TEMP_DIR/requirements.txt" ]]; then
- echo "Installing Python dependencies..."
- if command -v pip3 >/dev/null 2>&1; then
- pip3 install -q -r "$TEMP_DIR/requirements.txt" 2>/dev/null || {
- echo " ⚠️ pip install failed — you may need to run: pip3 install -r requirements.txt"
- }
- elif command -v pip >/dev/null 2>&1; then
- pip install -q -r "$TEMP_DIR/requirements.txt" 2>/dev/null || {
- echo " ⚠️ pip install failed — you may need to run: pip install -r requirements.txt"
- }
- else
- echo " ⚠️ pip not found — skipping Python dependencies"
- fi
- fi
- echo ""
- echo "✓ Installation complete!"
- echo ""
- echo "Usage:"
- echo " /email — Interactive email assistant menu"
- echo " /email check — Validate email before sending"
- echo " /email write — Compose professional emails"
- echo " /email review — Review and improve email drafts"
- echo " /email audit — Analyze email deliverability"
- echo " /email sequence — Build multi-email campaigns"
- echo " /email plan — Design email strategy"
- echo ""
- echo "Skills installed at: $SKILLS_DIR/email*"
- echo "Agents installed at: $AGENTS_DIR/email-*.md"
- echo ""
- }
- check_prerequisites() {
- if ! command -v python3 >/dev/null 2>&1; then
- echo "Error: python3 not found. Please install Python 3.7+."
- exit 1
- fi
- if ! command -v git >/dev/null 2>&1; then
- echo "Error: git not found. Please install git."
- exit 1
- fi
- }
- # Run main function (prevents partial execution on curl pipe)
- main "$@"
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.