timothy-node/email-channel

Email Channel

Two-way email communication via IMAP/SMTP.

When to Use

• User asks to send an email
• Responding to incoming emails (automatic)
• Sending notifications or reports via email

Sending Emails

Use the message tool with channel: "email":

message action=send channel=email [email protected] message="Your message here"

Parameters

| Parameter | Required | Description | |-----------|----------|-------------| | target | Yes | Recipient email address | | message | Yes | Email body (plain text or HTML) | | subject | No | Email subject | | replyTo | No | Message ID to reply to (maintains thread) |

Examples

Simple email:

message action=send channel=email [email protected] message="Hello! This is a test."

With subject:

message action=send channel=email [email protected] subject="Weekly Report" message="Here's your summary..."

Reply to thread:

message action=send channel=email [email protected] replyTo=<message-id> message="Thanks for your question..."

Receiving Emails

Emails from allowed senders automatically appear as user messages. The channel handles:

• IMAP polling at configured intervals
• Thread tracking via Message-ID/References headers
• Sender verification against allowlist

Attachments

Incoming attachments are processed and available in the message context.

To send attachments, use filePath or buffer:

message action=send channel=email [email protected] message="See attached" filePath=/path/to/file.pdf

Security Notes

1. Only addresses in allowFrom can trigger responses
2. Use ${ENV_VAR} syntax for passwords in config
3. App passwords recommended over account passwords

Troubleshooting

• Email not received: Check sender is in allowFrom list
• Send failed: Verify SMTP settings and credentials
• Thread broken: Ensure replyTo uses correct Message-ID format