@apilium/email

Email integration skill for Mayros -- IMAP read + SMTP send, search.

Installation

Copy this skill directory into your Mayros skills folder:

cp -r skills/email ~/.mayros/skills/email

Or install via the Mayros CLI:

mayros skill install @apilium/email

Configuration

Set the following environment variables:

| Variable | Description | Example | |----------|-------------|---------| | EMAIL_IMAP_HOST | IMAP server hostname | imap.gmail.com | | EMAIL_SMTP_HOST | SMTP server hostname | smtp.gmail.com | | EMAIL_USER | Email account username | [email protected] | | EMAIL_PASSWORD | Email account password or app password | xxxx-xxxx-xxxx-xxxx |

For Gmail, you must use an App Password instead of your regular password.

Usage

Once configured, the agent can:

• Read emails: Fetch messages from any folder, search by subject/sender/date
• Send emails: Compose and send with plain text, HTML, or attachments
• Search: Find messages by criteria (from, subject, date range, unread)
• Manage folders: List available mailbox folders

Example prompts

"Check my inbox for unread messages"
"Search for emails from [email protected] about invoices"
"Send an email to [email protected] with subject 'Meeting Notes'"
"List all email folders"

Semantic Predicates

| Predicate | Scope | Description | |-----------|-------|-------------| | email:sent | agent | Emails sent by the agent | | email:read | agent | Emails read by the agent | | email:inbox_context | agent | Inbox summary for context enrichment |

License

MIT