MakersFuel

Email Setup

Email Setup

Email integration allows your AI employee to send and receive emails. This is ideal for formal communications, customer support, and automated responses.

PicoClaw only. Email is not available for Moltis employees. If you need email capabilities, use a PicoClaw employee.

What You'll Need

  • An email account (Gmail, Outlook, or custom domain)
  • SMTP and IMAP server details
  • ~20 minutes for setup

Configuration Fields

Email uses the following fields:

FieldDescription
emailThe email address (used for both sending and login)
passwordEmail password or app password
smtp_hostOutgoing mail server hostname
smtp_portSMTP port (usually 587 for TLS or 465 for SSL)
imap_hostIncoming mail server hostname
imap_portIMAP port (usually 993 for SSL)
allow_fromComma-separated email addresses allowed to contact the bot (leave empty to allow all)

Gmail Setup

Gmail is the most common email provider. Follow these steps for Gmail configuration.

Step 1: Enable 2-Factor Authentication

Gmail requires app passwords, which need 2FA enabled first.

  1. Go to Google Account Security
  2. Find 2-Step Verification
  3. Follow the prompts to enable it

Step 2: Create App Password

  1. Go to Google App Passwords
  2. Select Mail as the app
  3. Select your device
  4. Click Generate
  5. Copy the 16-character password
Important: Save this password! You won't be able to see it again.

Step 3: Configure in MakersFuel

Use these settings for Gmail:

FieldValue
emailYour Gmail address
passwordThe app password (not your regular password)
smtp_hostsmtp.gmail.com
smtp_port587
imap_hostimap.gmail.com
imap_port993

Outlook/Microsoft 365 Setup

Step 1: Enable SMTP/IMAP

  1. Go to Outlook Settings
  2. Navigate to Mail -> Sync email
  3. Enable POP and IMAP

Step 2: App Password (if 2FA enabled)

  1. Go to Microsoft Security
  2. Create an app password for Mail

Step 3: Configure in MakersFuel

FieldValue
emailYour Outlook address
passwordYour password or app password
smtp_hostsmtp.office365.com
smtp_port587
imap_hostoutlook.office365.com
imap_port993

Custom Domain Setup

For professional use, configure your own domain's email.

Get SMTP/IMAP Details

Contact your email hosting provider or find settings in your email dashboard.

Common fields needed:

FieldExample
smtp_hostmail.yourdomain.com
smtp_port587 or 465
imap_hostmail.yourdomain.com
imap_port993

Email Authentication

For better deliverability, configure:

RecordPurpose
SPFAuthorize sending servers
DKIMEmail signature verification
DMARCPolicy for failed checks
Note: Without proper authentication, your emails may be marked as spam.

Configuration in MakersFuel

Add Email Channel

  1. Go to your employee's configuration page
  2. Find the Channels section
  3. Click Add Channel or enable Email

Enter Settings

Fill in the six required fields:

FieldDescription
emailYour email address
passwordEmail password or app password
smtp_hostOutgoing mail server
smtp_portUsually 587 (TLS) or 465 (SSL)
imap_hostIncoming mail server
imap_portUsually 993 (SSL)

Access Control

Use the allow_from field to restrict which email addresses can interact with the bot:

SettingDescription
Specific sendersComma-separated email addresses
All sendersLeave empty (responds to anyone)

Save

  1. Click Save to apply the configuration
  2. The employee will begin monitoring the inbox

Features

Supported Actions

ActionSupported
Read emailsYes
Send repliesYes
Send new emailsYes
AttachmentsYes
HTML formattingYes
ThreadingYes

Email Processing

Your employee can:

  • Parse email content and attachments
  • Extract information from emails
  • Generate contextual responses
  • Follow up on conversations

Troubleshooting

"Authentication failed"

  1. Check credentials -- Verify email and password
  2. Use app password -- Regular passwords may not work with Gmail/Outlook
  3. Enable access -- Some providers block "less secure apps"
  4. Check 2FA -- May require app password

"Connection refused"

  1. Verify host -- Check smtp_host and imap_host values
  2. Check port -- Try alternative ports (587, 465, 993)
  3. Check firewall -- Ensure ports are open
  4. Try different encryption -- SSL vs TLS

"Emails not being received"

  1. Check IMAP settings -- Verify imap_host and imap_port are correct
  2. Check allow_from -- May be filtering out the sender
  3. Check spam -- Emails may be in spam folder

"Emails going to spam"

  1. Configure SPF -- Add SPF record to DNS
  2. Configure DKIM -- Set up email signing
  3. Configure DMARC -- Add DMARC policy
  4. Warm up domain -- Gradually increase volume

"Slow responses"

Email is checked periodically, not in real-time:

  • Default check interval: Every few minutes
  • Consider other channels for urgent communication

Best Practices

PracticeWhy
Use dedicated emailSeparates bot from personal email
Configure authenticationImproves deliverability
Set clear expectationsEmail is not instant
Monitor spam reportsMaintain sender reputation

Security Considerations

ConsiderationRecommendation
Password storageUse app passwords, not main password
Access scopeCreate limited-access account if possible
MonitoringReview sent emails periodically
Sensitive dataBe careful with attachments

Next Steps

What did you think of this content?