email

name	email
description	AI-powered IMAP email client with semantic search, intelligent triage, and graduated autonomy. Manages email through natural conversation.
metadata	{"clawdbot":{"emoji":"📧","requires":{"bins":["node"]},"permissions":["network:imap","network:smtp"]}}
user-invocable	true

Email Skill

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

CLI Usage

Run commands via node:

node ~/projects/clawdbot-email/dist/cli.js <command> [options]

Commands

List inbox messages

node ~/projects/clawdbot-email/dist/cli.js inbox
node ~/projects/clawdbot-email/dist/cli.js inbox --limit 20

Read a specific message

node ~/projects/clawdbot-email/dist/cli.js read <uid>

Semantic search

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

List folders

node ~/projects/clawdbot-email/dist/cli.js folders

Archive message

node ~/projects/clawdbot-email/dist/cli.js archive <uid>

Delete message (move to trash)

node ~/projects/clawdbot-email/dist/cli.js delete <uid>

Move message to folder

node ~/projects/clawdbot-email/dist/cli.js move <uid> Projects

Star/flag message

node ~/projects/clawdbot-email/dist/cli.js star <uid>

Mark as read

node ~/projects/clawdbot-email/dist/cli.js mark-read <uid>

Compose and send email

# Simple send
node ~/projects/clawdbot-email/dist/cli.js send \
  --to "[e-mail]" \
  --subject "Hello" \
  --body "Email body text"

# Multiple recipients
node ~/projects/clawdbot-email/dist/cli.js send \
  --to "[e-mail],[e-mail]" \
  --cc "[e-mail]" \
  --bcc "[e-mail]" \
  --subject "Team Update" \
  --body "Meeting notes..."

# Body from stdin
echo "Message body" | node ~/projects/clawdbot-email/dist/cli.js send \
  --to "[e-mail]" \
  --subject "Piped content" \
  --stdin

Reply to message

# 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

node ~/projects/clawdbot-email/dist/cli.js forward <uid> --to "[e-mail]"
node ~/projects/clawdbot-email/dist/cli.js forward <uid> --to "[e-mail]" --body "FYI"

List attachments

node ~/projects/clawdbot-email/dist/cli.js attachments <uid>

Download attachments

# 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

node ~/projects/clawdbot-email/dist/cli.js accounts

Add account

node ~/projects/clawdbot-email/dist/cli.js accounts add \
  --imap-host imap.gmail.com \
  --email [e-mail] \
  --password "app-password" \
  --provider gmail

Remove account

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

Settings

View settings

node ~/projects/clawdbot-email/dist/cli.js settings

Set autonomy level

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