U1F4E7

Envelope: A BYO IMAP Email API for Agents

The U1F4E7 project, known as Envelope, is a streamlined API designed for agents to send emails without extensive setup. With an agent-first architecture, Envelope allows users to connect their existing email accounts without the need for domain configuration, high costs, or tedious setup procedures.

Key Features

• User-Friendly Setup: Simply add an email address and SMTP password, and your agent can immediately begin sending emails on your behalf with your approval.

# Add a mailbox
git clone https://github.com/tymrtn/U1F4E7.git && cd U1F4E7
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
uvicorn app.main:app --reload

• Approval Flows Enforced: Unlike raw SMTP libraries, Envelope incorporates an approval gate, ensuring all email communications are reviewed by a human before sending. Here’s how it works:

  1. The agent drafts an email.
  2. The draft is sent to a review queue.
  3. A human reviews and either approves or rejects the draft.

• Full Audit Trail: Every email draft and its approval status are logged, providing a complete record of actions taken for accountability.

Seamless Integration with OpenClaw

Envelope is specifically designed to integrate with OpenClaw and other agent frameworks that utilize MCP (Multi-Channel Protocol). This allows for easy connection and control of the email sending process.

Comparison with Alternatives

Envelope distinguishes itself from similar services such as Himalaya, Resend, and Mailgun in several key areas:

• No New Domain Required: Use existing email accounts without dealing with DNS settings or per-message charges.
• Configurable Approval Gates: Ensures all sends are vetted, particularly vital for sensitive communications like client interactions.
• Audit Log: Tracks all actions for compliance and transparency.

Production Ready

Built with scalability in mind, Envelope employs asynchronous communication and offers database options that cater to production environments. Key elements include:

• Connection Pooling
• Rate Limiting
• Webhook Support for Delivery Events

Additional Capabilities

• Email Composition: Send emails complete with attachments and various headers.
• Inbox Management: Access inbox messages through IMAP and manage communications efficiently.
• Web UI Dashboard: An interface for reviewing drafts, approving emails, and managing settings.

Future Developments

Envelope continues to evolve, with a roadmap that includes SDK development for various platforms, support for OAuth2 authentication, and multi-tenant capabilities.

For more information about the detailed architecture, API usage, and contribution guidelines, visit the repository.