--- 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: ```bash node ~\/projects\/clawdbot-email\/dist\/cli.js [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 ``` ### 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 ``` ### Delete message (move to trash) ```bash node ~\/projects\/clawdbot-email\/dist\/cli.js delete ``` ### Move message to folder ```bash node ~\/projects\/clawdbot-email\/dist\/cli.js move Projects ``` ### Star\/flag message ```bash node ~\/projects\/clawdbot-email\/dist\/cli.js star ``` ### Mark as read ```bash node ~\/projects\/clawdbot-email\/dist\/cli.js mark-read ``` ### 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 --body "Thank you for your email" # Reply all node ~\/projects\/clawdbot-email\/dist\/cli.js reply --body "Response" --all ``` ### Forward message ```bash node ~\/projects\/clawdbot-email\/dist\/cli.js forward --to "colleague@example.com" node ~\/projects\/clawdbot-email\/dist\/cli.js forward --to "user@example.com" --body "FYI" ``` ### List attachments ```bash node ~\/projects\/clawdbot-email\/dist\/cli.js attachments ``` ### Download attachments ```bash # Download all attachments node ~\/projects\/clawdbot-email\/dist\/cli.js download # Download specific attachment by index node ~\/projects\/clawdbot-email\/dist\/cli.js download 0 # Download to specific path node ~\/projects\/clawdbot-email\/dist\/cli.js download --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 ``` ## 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