# Email

> AI-powered IMAP email client with semantic search, intelligent triage, and graduated autonomy. Manages email through natural conversation.

- Skill: `kimasplund/email` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add kimasplund/email`
- Raw SKILL.md: https://api.skillmd.com/api/skills/kimasplund/email/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- Author: kimasplund (https://skillmd.com/u/kimasplund)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/kimasplund/email

---


# Email Skill

Manage your email through natural conversation with AI-powered intelligence.

## CLI Usage

Run commands via node:
```bash
node ~/projects/clawdbot-email/dist/cli.js <command> [options]
```

## Commands

### List inbox messages
```bash
node ~/projects/clawdbot-email/dist/cli.js inbox
node ~/projects/clawdbot-email/dist/cli.js inbox --limit 20
```

### Read a specific message
```bash
node ~/projects/clawdbot-email/dist/cli.js read <uid>
```

### Semantic search
```bash
node ~/projects/clawdbot-email/dist/cli.js search "project deadlines"
node ~/projects/clawdbot-email/dist/cli.js search "invoices from last month"
```

### List folders
```bash
node ~/projects/clawdbot-email/dist/cli.js folders
```

### Archive message
```bash
node ~/projects/clawdbot-email/dist/cli.js archive <uid>
```

### Delete message (move to trash)
```bash
node ~/projects/clawdbot-email/dist/cli.js delete <uid>
```

### Move message to folder
```bash
node ~/projects/clawdbot-email/dist/cli.js move <uid> Projects
```

### Star/flag message
```bash
node ~/projects/clawdbot-email/dist/cli.js star <uid>
```

### Mark as read
```bash
node ~/projects/clawdbot-email/dist/cli.js mark-read <uid>
```

### Compose and send email
```bash
# Simple send
node ~/projects/clawdbot-email/dist/cli.js send \
  --to "recipient@example.com" \
  --subject "Hello" \
  --body "Email body text"

# Multiple recipients
node ~/projects/clawdbot-email/dist/cli.js send \
  --to "a@example.com,b@example.com" \
  --cc "c@example.com" \
  --bcc "d@example.com" \
  --subject "Team Update" \
  --body "Meeting notes..."

# Body from stdin
echo "Message body" | node ~/projects/clawdbot-email/dist/cli.js send \
  --to "user@example.com" \
  --subject "Piped content" \
  --stdin
```

### Reply to message
```bash
# Reply to sender
node ~/projects/clawdbot-email/dist/cli.js reply <uid> --body "Thank you for your email"

# Reply all
node ~/projects/clawdbot-email/dist/cli.js reply <uid> --body "Response" --all
```

### Forward message
```bash
node ~/projects/clawdbot-email/dist/cli.js forward <uid> --to "colleague@example.com"
node ~/projects/clawdbot-email/dist/cli.js forward <uid> --to "user@example.com" --body "FYI"
```

### List attachments
```bash
node ~/projects/clawdbot-email/dist/cli.js attachments <uid>
```

### Download attachments
```bash
# Download all attachments
node ~/projects/clawdbot-email/dist/cli.js download <uid>

# Download specific attachment by index
node ~/projects/clawdbot-email/dist/cli.js download <uid> 0

# Download to specific path
node ~/projects/clawdbot-email/dist/cli.js download <uid> --output ./downloads/
```

## Account Management

### List accounts
```bash
node ~/projects/clawdbot-email/dist/cli.js accounts
```

### Add account
```bash
node ~/projects/clawdbot-email/dist/cli.js accounts add \
  --imap-host imap.gmail.com \
  --email user@gmail.com \
  --password "app-password" \
  --provider gmail
```

### Remove account
```bash
node ~/projects/clawdbot-email/dist/cli.js accounts remove <account-id>
```

## Settings

### View settings
```bash
node ~/projects/clawdbot-email/dist/cli.js settings
```

### Set autonomy level
```bash
node ~/projects/clawdbot-email/dist/cli.js settings --autonomy L1
```

## Autonomy Levels

| Level | Description |
|-------|-------------|
| L0 | Manual: All actions require confirmation |
| L1 | Assisted: Read auto, writes need confirmation |
| L2 | Supervised: Most auto, sends need confirmation |
| L3 | Autonomous: Full automation (use with caution) |

## Environment Variables

- `EMAIL_CONFIG_PATH` - Config directory path (default: ~/.clawdbot/email)

## Provider Support

- Gmail (imap.gmail.com)
- Outlook (outlook.office365.com)
- iCloud (imap.mail.me.com)
- Yahoo (imap.mail.yahoo.com)
- FastMail (imap.fastmail.com)
- ProtonMail (127.0.0.1 via bridge)
- Any IMAP server