Email (IMAP) Connector

Connect Zenmako to your email account via IMAP and SMTP to read, search, organize, and send emails. This enables AI to check your inbox, summarize unread messages, reply to emails, and manage folders.

Getting Your Credentials

The Email IMAP connector requires your email login credentials plus server settings. Most email providers require an app password instead of your regular password.

Required Information

Field

Description

Username	Your full email address (e.g., you@gmail.com)
Password	Your email password or app-specific password
IMAP Host	IMAP server address (e.g., imap.gmail.com)
IMAP Port	IMAP port number (usually 993 for SSL/TLS)
SMTP Host	SMTP server address (e.g., smtp.gmail.com)
SMTP Port	SMTP port number (usually 587 for STARTTLS)

App Passwords

Most email providers with two-factor authentication require an app password. Here is how to generate one:

Gmail:

Go to https://myaccount.google.com/apppasswords

Select "Mail" for the app and your device type

Click "Generate"

Copy the 16-character password (use this instead of your regular password)

Outlook/Microsoft 365:

Go to https://account.microsoft.com/security

Select "Advanced security options"

Under "App passwords", click "Create a new app password"

Copy the generated password

Yahoo:

Go to https://login.yahoo.com/account/security

Click "Generate app password"

Select "Other App" and enter "Zenmako"

Copy the generated password

Common Server Settings

Provider

IMAP Host

IMAP Port

SMTP Host

SMTP Port

Gmail	imap.gmail.com	993	smtp.gmail.com	587
Outlook/Hotmail	outlook.office365.com	993	smtp.office365.com	587
Yahoo	imap.mail.yahoo.com	993	smtp.mail.yahoo.com	587
iCloud	imap.mail.me.com	993	smtp.mail.me.com	587
Fastmail	imap.fastmail.com	993	smtp.fastmail.com	587

Connecting Email

Navigate to the Connections page in Zenmako

Click Add Connection and select Email (IMAP)

Enter your credentials:

- Username: Your full email address - Password: Your app password (or regular password if app passwords are not required) - IMAP Host: Your email provider's IMAP server address - IMAP Port: 993 (default for secure connections) - SMTP Host: Your email provider's SMTP server address - SMTP Port: 587 (default for STARTTLS) - TLS: Leave enabled for secure connections (recommended)

Click Save

Click Test Connection to verify the setup works

If the test succeeds, your email connection is ready to use.

Available Actions

Action

Description

getUnreadSummary	Get a summary of unread emails with count by sender and subjects
searchEmailsByCriteria	Search emails by sender, subject, date range, or unread status
getEmailForReply	Get email details formatted for replying (includes body, headers, and context)
composeReply	Compose and send a reply email with proper headers and threading
sendEmailWithDraftCheck	Send an email, using an existing draft if one is available
bulkMoveEmails	Move multiple emails to a folder in a single operation
listFolders	List all available IMAP folders in the mailbox
createFolder	Create a new email folder (idempotent - safe to call if folder already exists)

Example Prompts

Try these prompts to interact with your email:

"How many unread emails do I have? Summarize them by sender."

"Find all emails from john@example.com in the last week"

"Search for unread emails with 'invoice' in the subject"

"Reply to the email from Sarah about the meeting with: Thanks, I will be there at 3pm"

"Move all newsletters to a folder called 'Newsletters'"

"Show me my email folders"

Common Issues

"Authentication failed" or "Invalid credentials" error

This usually means your password is incorrect or you need an app password. Solutions:

If you use two-factor authentication, generate an app password (see instructions above)

Verify you copied the password without extra spaces

For Gmail, ensure "Less secure app access" is enabled if you are not using an app password (not recommended)

For Gmail, check that IMAP is enabled in Gmail Settings under "Forwarding and POP/IMAP"

"Connection refused" or "Cannot connect to server" error

This indicates the server settings are incorrect or the connection is blocked. Solutions:

Verify the IMAP and SMTP host addresses are correct for your email provider

Check that you are using the correct port numbers (993 for IMAP, 587 for SMTP)

Ensure TLS is enabled if your provider requires secure connections

If on a corporate network, check if IMAP/SMTP ports are blocked by a firewall