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