purelymail

Set up and test PurelyMail email for Clawdbot agents. Generate configs, test IMAP/SMTP, verify inbox connectivity.

⭐3stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill streamlines the integration of PurelyMail with Clawdbot agents, providing a comprehensive suite for email setup, configuration, and connectivity testing. It enables developers to quickly equip AI agents with reliable IMAP/SMTP capabilities, ensuring seamless automated email communication and inbox management for AI-driven workflows.

Use Cases

  • Automated Agent Inbox Setup: Quickly configure dedicated, low-cost email accounts for AI agents using PurelyMail's privacy-focused service.
  • Connectivity Verification: Use the built-in testing tools to validate IMAP and SMTP settings, preventing communication failures in agent-led outreach.
  • Configuration Generation: Automatically generate the necessary JSON snippets for clawdbot.json to manage environment variables and credentials securely.
  • Email Workflow Testing: Send and receive test emails to verify deliverability and inbox access before deploying autonomous agents to production.
  • Inbox Management: Monitor and read incoming messages directly through the agent interface to facilitate task-based email processing.
namepurelymail
descriptionSet up and test PurelyMail email for Clawdbot agents. Generate configs, test IMAP/SMTP, verify inbox connectivity.
homepagehttps://purelymail.com
emoji"📬"
bins["python3"]

PurelyMail Setup for Clawdbot

Set up email for your Clawdbot agent using PurelyMail - a simple, privacy-focused email service perfect for agent inboxes.

Why PurelyMail?

  • Cheap: ~$10/year for unlimited addresses
  • Simple: No bloat, just email
  • Privacy: Based in US, minimal data retention
  • Reliable: Great deliverability
  • Agent-friendly: Easy IMAP/SMTP setup

Quick Start (Wizard)

The easiest way to set up is with the interactive wizard:

purelymail wizard

The wizard will:

  1. ✓ Check if you have a PurelyMail account
  2. ✓ Test your IMAP/SMTP connection
  3. ✓ Generate clawdbot.json config
  4. ✓ Optionally send a test email

Manual Setup

1. Create PurelyMail Account

  1. Go to purelymail.com and sign up
  2. Add your domain (or use their subdomain)
  3. Create a mailbox for your agent (e.g., agent@yourdomain.com)
  4. Note the password

2. Generate Clawdbot Config

purelymail config --email agent@yourdomain.com --password "YourPassword"

Outputs JSON to add to your clawdbot.json:

{
  "skills": {
    "entries": {
      "agent-email": {
        "env": {
          "AGENT_EMAIL": "agent@yourdomain.com",
          "AGENT_EMAIL_PASSWORD": "YourPassword",
          "AGENT_IMAP_SERVER": "imap.purelymail.com",
          "AGENT_SMTP_SERVER": "smtp.purelymail.com"
        }
      }
    }
  }
}

3. Test Connection

purelymail test --email agent@yourdomain.com --password "YourPassword"

Tests IMAP and SMTP connectivity.

4. Send Test Email

purelymail send-test --email agent@yourdomain.com --password "YourPassword" --to you@example.com

5. Check Inbox

purelymail inbox --email agent@yourdomain.com --password "YourPassword" --limit 5

Commands

Command Description
config Generate clawdbot.json config snippet
test Test IMAP/SMTP connectivity
send-test Send a test email
inbox List recent inbox messages
read Read a specific email
setup-guide Print full setup instructions

Environment Variables

Once configured in clawdbot.json, these env vars are available:

  • AGENT_EMAIL - The email address
  • AGENT_EMAIL_PASSWORD - The password
  • AGENT_IMAP_SERVER - IMAP server (imap.purelymail.com)
  • AGENT_SMTP_SERVER - SMTP server (smtp.purelymail.com)

PurelyMail Settings

Setting Value
IMAP Server imap.purelymail.com
IMAP Port 993 (SSL)
SMTP Server smtp.purelymail.com
SMTP Port 465 (SSL) or 587 (STARTTLS)
Auth Email + Password

Tips

  • Use a strong, unique password for your agent
  • Consider creating a dedicated domain for agent emails
  • PurelyMail supports catch-all addresses (great for routing)
  • Enable 2FA on your PurelyMail account (use app password for agent)